MachineShop 

Shell Runtime Guide 


CTC Parker Automation Phone: 513-831-2340 

50 W. TechneCenter Drive, Milford, Ohio 45150 Technical Support: 513-248-1714 


A3-05727-104 



Copyright and Trademark Notice 

Copyright © 2004 by CTC Parker Automation. All rights reserved. No part of this 
publication may be reproduced, transmitted, transcribed, stored in a retrieval 
system, in any form or by any means, mechanical, photocopying, recording or 
otherwise, without the prior written consent of CTC Parker Automation. 

While every precaution has been taken in the preparation of this manual, CTC 
Parker Automation and the author assume no responsibility for errors or omissions. 
Neither is any liability assumed for damages resulting from the use of the informa¬ 
tion contained herein. All product and company names are trademarks of their 
respective companies and licenses. 

Product Warranty Information 
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Chapter 1 


Manual Overview and 
Support Services 

Welcome to the MachineShop Shell. The MachineShop Shell is a 
software program that runs on the runtime workstation. It is used 
to configure many of the unit’s hardware and software settings and 
to receive Interact and MachineLogic files downloaded from a 
development system. It also handles certain project-related tasks 
including backup and restore operations. 

Chapter Contents 


Using This Manuai 
Documentation Standards 
Customer Support Services 
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Using This Manuai 


Chapter 1: Manual Overview and Support Services 


Using This 
Manuai 


The MachineShop Shell Runtime User Guide deseribes 
the MaehineShop Shell user interfaee and provides 
instruetions on how to monitor and eonfigure system 
settings from the Shell. 

Chapter 1 - Manual Overview and Support: Presents 
an overview of the doeumentation that is provided with 
the MaehineShop Shell. This ehapter also diseusses the 
support serviees provided by CTC-Parker. 

Chapter 2 - Introducing the MachineShop Shell: 

Deseribes how to navigate in the MaehineShop Shell, how 
to get online help, and introduees you to the user interfaee. 

Chapter 3 - System Administrator Functions: Provides 
instruetional information on using the MaehineShop Shell 
to perform administrator funetions sueh as seleeting the 
startup program, ereating and restoring baekups, and 
adding language files to the runtime workstation. The 
runtime workstation is the PC or CTC-Parker PowerSta- 
tion on whieh the Shell is running. 

Chapter 4 - Maintaining the PowerStation: Provides 
instruetions for reealibrating the touehsereen, performing 
a keyboard test, adjusting the brightness and eontrast 
levels of the PowerStation display, and eonfiguring the 
Shift and Seleet keys on P5 PowerStations. 

Chapter 5 - Preparing for Transfers: Deseribes how to 
set up the runtime workstation for transfers with a devel¬ 
opment system running the MaehineShop Toolbar. These 
eonneetions inelude the Direet Serial, serial PPP, LAN, 
and Ethernet Point to Point. 

Chapter 6 - MachineLogic: Deseribes how to use the 

MaehineLogie option to eonfigure settings for MaehineL- 
ogie PC Control (MLPC) and for the MaehineLogie Slot 
Card (MLSC). It also provides instruetions for starting 
and stopping the MaehineLogie runtime kernel and reset¬ 
ting both the Watehdog timer and the Slot Card itself. 

Appendix A - Configuration Files: Provides the text of 
the files that are required for MaehineShop Shell and the 
MaehineLogie runtime system. 

Appendix B - Installing the MachineShop Shell - 
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Using This Manual 


Describes how to install the MachineShop Shell on a non- 
CTC-Parker workstation. A non-CTC-Parker workstation 
is any runtime PC, other than a PowerStation, on which 
you are running the Shell. 
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Documentation Standards 


Chapter 1: Manual Overview and Support Services 


Documentation 

Standards 


ISO Symbols 



As you read this manual, you will notice that the 
following documentation standards have been followed. 

1 . Important terms are shown in bold. 

2. Text to he entered from the keyboard is shown in 

Courier font. 

3. Buttons, menu titles, and keyboard keys are shown in 

Initial Caps. 

4. Indented paragraphs denote one of the following: 

• Note - Describes alternative approaches or issues 
you should be aware of while using a particular 
function. 

• Important - Contains information that needs par¬ 
ticular attention while reading the text. Follow 
this information to save development time and/or 
minimize problems. 

• Warning - Contains information on safety issues. 
Follow this information to prevent equipment 
damage or personal injury. 

This symbol is the International Standards Organization 
(ISO) symbol for Caution (ISO 3864 No. B.3.1). This 
symbol denotes information that could affect operation of 
the PowerStation if not properly followed. 

This symbol is the ISO symbol for Caution - risk of elec¬ 
trical shock (ISO 3864 No B.3.6). This symbol denotes 
information that could cause personal injury from elec¬ 
trical shock or damage to equipment if not properly 
followed. 
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Customer Support Services 


Customer 

Support 

Services 


CTC welcomes your thoughts and suggestions on our 
products and services. You can contact CTC by tele¬ 
phone, email, or fax. You can also visit CTC on the World 
Wide Web to learn the latest about CTC hardware, soft¬ 
ware, and customer support services. 

• Telephone: 513-831-2340 

• Fax:513-831-5042 

• E-mail: sales@ctcusa.com or support@ctcusa.com 

• World Wide Web: http://www.ctcusa.com 

CTC recognizes that every customer and every applica¬ 
tion has different support needs, so CTC offers a variety 
of support services designed to meet those needs. CTC 
offers three types of customer support services: Technical 
Support, Training and New Business Development, and 
the Product Support Program. 


Technical Support The Technical Support department welcomes any ques¬ 
tion that might arise as you develop or run your applica¬ 
tions. We offer complimentary support for any customer, 
whether you are an end-user, original equipment manu¬ 
facturer (OEM), or system integrator. 

If you have a question about MachineShop Shell, be 
sure to complete the following steps: 

1. Consult the appropriate documentation included with 
the MachineShop Shell. 

2. Check the online help. The MachineShop Shell has 
extensive online help facilities that cover all aspects 
of the product. 

If you cannot find a solution using one of the above 
sources, contact CTC’s Product Technical Support 
department at 513-248-1714, 8:00 a.m. to 5:00 p.m., EST. 
You may call this same number after hours for emergency 
assistance. 
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Chapter 1: Manual Overview and Support Services 


Training and New 
Business 
Deveiopment 


Product Support 
Program 


Our Training and New Business Development department 
provides serviee in two areas: training and eonsulting. 
CTC offers training on all our produets either at CTC in 
our state-of-the-art training eenter or at your site. You ean 
learn how to write eustom interfaees, develop speeialized 
applieations, and implement your eomplete, maehine 
eontrol applieation. You ean eontaet the Training Coordi¬ 
nator by phone at 1-800-233-3329 or by email at 
training @ eteusa.eom. 

CTC Parker offers eonsulting serviees through our Appli¬ 
eation Engineering Serviees group. Whether you need 
help writing a program for MaebineLogie^M PC-based 
Logie eontrol, developing sereens for Internet HMI or 
eonneeting our produets to other deviees, CTC’s Applica¬ 
tion Engineering Group will advise and work with your 
people to provide the right solution. You can contact 
Application Engineering Services by phone at 1-800-233- 
3329 or by email at appeng@ctcusa.com . 

The Product Support Program (PSP) is designed to keep 
you up-to-date with the current version of MachineShop 
software. The PSP consists of a renewable, one-year 
membership that provides you with free upgrades, utili¬ 
ties, automatic notification of software updates, and other 
valuable tools for MachineShop. Single-user, site, and 
corporate licenses are available. The PSP is an easy, cost- 
effective way to automatically receive the most recent 
Interact software and the associated utilities. You can 
contact the PSP Coordinator by phone at 1-800-233-3329 
or by email at psp@ctcusa.com. 
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Chapter 2 


Introducing MachineShop 
Shell 

The MachineShop Shell (referred to as “the Shell” throughout this 
manual) is the primary user interface for runtime workstations. 
The Shell was developed in conjunction with MachineShop to 
provide essential communication functions between a develop¬ 
ment system running the MachineShop Toolbar and a runtime 
workstation running the Shell. These communication functions 
include downloading and uploading files and projects and creating 
and restoring remote backups. The Shell also provides support 
functions for configuring and maintaining the runtime worksta¬ 
tion. 

This chapter introduces you to the MachineShop Shell and its 
components. It also includes information about getting around the 
user interface and how to get help. 

Chapter Contents 


Shell Basics 
Shell User Interface 
Shell Main Menu 
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Shell Basics 


Chapter 2: Introducing MachineShop Shell 


Shell Basics 


Navigating the Sheii 


The MachineShop Shell interfaces with the PowerStation, 
or other runtime workstation, and its installed components 
(hardware and software). The Shell displays detailed 
information about the workstation and allows you to 
monitor and configure many of the workstation’s hard¬ 
ware and software settings. 

The purpose of the Shell is to simplify navigation and 
configuration of the workstation from a central source. It 
is designed to reduce the number of steps to perform a task 
and to minimize the complexity of the system. 

The Shell must be able to download MachineShop 
projects from your development system to the runtime 
workstation on which the Shell is running. 

You can navigate and make selections within the 
MachineShop Shell by using the touchscreen, or an 
attached mouse or keyboard. 

Using the Touchscreen 

When using the touchscreen, press on a selection area 
(such as a button) to make a selection. Throughout this 
documentation it is assumed you are using the touch¬ 
screen to navigate the Shell and to make selections. 

Using the Mouse 

To use a mouse, move the cursor over a selection area or 
button, and click to make the selection. 

Using a Keyboard 

To make a selection with a keyboard, press the key on the 
keyboard that corresponds to the hot key, or highlighted 
letter, on a displayed menu button. This will select and 
activate the selection at the same time. For instance, to 
select the EXIT button on the main menu, press the E key 
on the keyboard. 

Some submenu options do not have hot keys. In these 
cases you can use ENTER to select the option and ESC to 
cancel the option. 
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Shell Basics 


Shell Keypads 


You can also use the TAB and arrow keys to move the 
cursor on the screen to a selection area or button. Press the 
TAB key to cycle the cursor forward through the screen. 
To reverse the direction of the cursor, press SHIFT+TAB. 
Press ENTER when the cursor is over a selection to make 
the selection. 

Moving between screens 

Screens that are longer than one page will display a set of 
small up and down arrows in the upper right section of the 
Shell screen in the Title Area. These arrows scroll to 
information that cannot fit inside the standard display 
area. 

To scroll to another screen, complete one of the 
following steps: 

• Press the arrow on the touchscreen. 

• Move the cursor over an arrow and click the mouse 
button. 

• Press the PAGE UP and PAGE DOWN buttons on 
the keyboard. 

Whenever information is displayed in an additional screen 
or whenever you access a menu other than the main menu, 
a BACK button will display below the Help button. Press 
this button or press B on a keyboard to go back to the 
previous screen. 

To exit or cancel a selection, complete one of the 
following steps: 

• Press the touchscreen on an area outside the dis¬ 
played menu. 

• Press the ESC key on the keyboard. 

Menu options that require input values will automatically 
display an onscreen pop-up keypad. 

To use the keypad, complete the following steps: 

1. Enter values by selecting the keypad number on the 
screen. 
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System Control 
Status 


Getting Help 


2. Do one of the following: 

• Seleet ENTER to input the displayed value. 

• Seleet BACKSPACE to elear the last number dis¬ 
played in the keypad pop-up. 

• Seleet ESC to eaneel the keypad seleetion and 
exit the keypad sereen. 

During eertain remote operations, the development station 
used to manage the runtime workstation will temporarily 
disable operation of the Shell. Examples of remote opera¬ 
tions inelude file transfers, projeet backup and restore, 
and system information checks. 

When a remote operation occurs, a status screen will 
display on the runtime workstation. This screen will 
continue to display until the operation is finished or 
aborted. 

To obtain online help on a selection, press the El function 
key, or press the HEEP button above the main menu. A 
page of text is displayed in the display area of the screen. 

To exit a Help screen and return to the previous screen, 
select the BACK button located below the Help button. 
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Shell User Interface 


Shell User 
Interface 


The MachineShop Shell screen appears in the center of 
the screen and is capable of displaying up to 256 colors, 
depending on the installed video system. The Main Menu 
of the MachineShop Shell is displayed below: 


Help 

Button' 


CIC™ MachineShop stittf 


HELP 



-Title Area 


Display 

Area 


Submenu 


The screen is organized into five major components: 

• Title Area - The Title Area is an open line across the 
top of the screen that can display a company name or 
logo. 

• Help Button - The Help Button is located on the left 
side of the screen above the Main Menu. It allows 
you to obtain context-sensitive help for a displayed 
menu or submenu. 

• Menu Buttons - There are six vertically aligned menu 
buttons on the left side of the screen below the Help 
button. The selections that these buttons offer 
changes as you navigate through the Shell. 

• Submenu - The Submenu is a group of horizontal 
buttons that typically appear when you press a menu 
button on the Main Menu. These submenus give you 
additional workstation information and configuration 
options. 
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Shell Main Menu 


Chapter 2: Introducing MachineShop Shell 


• Display Area - The Display Area is the seetion of 
screen located to the right of the menu buttons. The 
Display Area displays information pertaining to the 
menu and submenu options as well as the Help. This 
information changes as the menu buttons change, 
according to the user’s selections. 


Shell Main Menu The menu buttons on the Main Menu are the primary 

method for navigating through the Shell options. This 
section provides a description of each menu button on the 
Shell Main Menu. 

Run The Run menu button allows you to execute Interact 

directly from the Shell. When the Interact runtime session 
is completed, you are returned to the Shell. An example of 
the Run submenu is shown below. 


CIC^ KliclimeShopsfte// 





Interact 

Modules: PTM, AMM, GMM, HTM, MCM, RCM, 
RPM, UPM 
Drivers: DVR, MLD 
Applications: AMMEXAMP, GMMEXAMP, 
HTMEXAMP, MCMEXAMP. 
EXAMPLE, RCMEXAMP, 
RPMEXAMP, UPMEXAMP, 
256EXAMP, TUTORIAL 

(MachineLogic is not installed) 
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Shell Main Menu 


Settings The Settings menu button allows you to view and edit 

various Shell and PowerStation eonfiguration options. An 
example of the Settings submenu is shown below: 


Cro™ MachineShop sAtw 


HELP 



• General - This option displays eurrent eonfiguration 
settings and allows you to modify general runtime 
settings ineluding whether Internet or the Shell will 
launeh on start up, enabling MaehineLogic at start 
up, seleeting the display type for non-CTC worksta¬ 
tions, and setting the workstation’s internal time and 
date. 

• PowerStation - This option displays eurrent Power- 
Station settings. It also allows you to ealibrate the 
touehsereen, perform a keyboard test, adjust the 
brightness and eontrast levels of the sereen (if avail¬ 
able), and program the Shift and Seleet keys on a P5 
PowerStation. 

Note The PowerStation option will be displayed only if 
the Shell is running on a PowerStation. 

• Direct Serial - Direet Serial eommunieation supports 
eommunieation between a development system and a 
runtime workstation that are eonneeted to eaeh other 
by a null modem serial eable. This option lets you 
transfer MaehineShop projeet files to the runtime 
workstation. 

• TCP/IP - This option is used to display and eonfig- 
ure the TCP/IP settings (IP address, host name, ete.) 
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Shell Main Menu 


Chapter 2: Introducing MachineShop Shell 


for the runtime workstation. You may eonfigure up to 
three TCP/IP conneetions. 

• FTP - This option is used to display and eonfigure 
the File Transfer Protoeol (FTP) settings for the run¬ 
time workstation. You ean optionally assign a user 
name and password in order to perform projeet trans¬ 
fers using FTP. 

Info The Info menu button allows you to view information 

about the eurrent hardware and software installed on the 
unit. An example of the Info submenu is shown below. 


CiC^ miicliineShoiisfte// 


HELP 



PROJECT INFORHOTIOn 

Project Mame: Sample 
Interact 

Modules: PTtl. ntltl. GMtl. HTM. HCfl. RCH. 


SYSTEM VERSIONS 


EXAMPLE, RCMEXAMP, 
RPMEXAMP, UPMEXAMP. 
256EXAMP. TUTORIAL 

(MachineLogic is not installed) 


• System - This option displays information about the 
proeessor, the amount of available eonventional and 
extended memory, the logieal drive assignment, and 
the port address assignments for all printer and serial 
ports in the workstation. 

• Versions - This option displays version numbers for 
the Internet Applieation Manager, Modules, and 
Drivers. It also displays the version number for 
MaehineLogie, support software, and workstation 
software. 

Utilities The Utilities menu button allows you to manage projeets 
and to eonfigure various hardware and software eompo- 
nents ineluding the Internet Seeurity Key and MaehineL¬ 
ogie. An example of the Utilities submenu is shown 
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Shell Main Menu 


below. 


CIC^ 

B MachineShop $/)«// 



HBBH 

r 

PROJECT inFORnOTlON 

Project ItrPrf16 

Intor*ci 

PTH 








1 






Note The Backup option is only available if a project 
has been downloaded to the runtime workstation. 
The MachineLogic option is only available if 
MachineLogic is included in the downloaded 
project. 

• Backup - This option allows you to archive the cur¬ 
rent project to a selected path. Backups are automati¬ 
cally compressed using the zip compression method. 
It also allows you to configure or edit the project 
backup path(s). 

• Restore - This option allows you to restore an 
archived backup project from a selected path. When 
you restore a project, the archived project is automat¬ 
ically decompressed and loaded on the unit. It also 
allows you to configure and edit the project restore 
path(s). 

• Security Key - This option displays software secu¬ 
rity key information and lists the enabled software 
components installed on the runtime workstation. It 
also allows you to enable and transfer key options 
between Security Keys. 

• MachineLogic - This option displays information 
about MachineLogic. This includes the runtime tar¬ 
get (MLPC or MLSC), system and I/O device errors, 
and tasks included in the MachineLogic project. It 
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Chapter 2: Introducing MachineShop Shell 


also allows you to configure the MLCA and the 
MLSC, depending on which you have installed. 

Note For more information about the MLPC (Machine- 
Logic PC Control) with the MLCA (MachineL- 
ogic Control Adapter), and the MLSC 
(MachineLogic Slot Card), see Chapter 6. 


Language The Language menu button lets you to select the language 
used by Shell to display text and online help files. An 
example of the Language submenu is shown below. 


CTC^ miacliineSliopsfte// 



PROJECT inFORHOTION 

Project Mame: Sample 
Interact 

Modules: PTM, AMM, GMM, HTM, MCM, RCM, 
RPM, UPM 
Drivers: DVR, MLD 
Applications: AMMEXAriP, GMMEXAMP, 
HTMEXAMP, MCMEXAMP. 
EXAMPLE, RCMEXAMP, 
RPMEXAMP, UPMEXAMP, 


Note Only languages with language files detected by 

the Shell will display in the menu. 

Exit Select the Exit menu button to exit MachineShop Shell 
and return to DOS. Before exiting the Shell, a submenu 
appears asking you if you really wish to exit the Shell. To 
cancel the Exit selection, press No or select an area 
outside of the submenu. 
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System Administrator 
Functions 

The MachineShop Shell lets you configure various features for 
using the runtime workstation with Interact and MachineLogic. 
This chapter will show you how to use MachineShop Shell to 
perform project-related tasks including backup and restore opera¬ 
tions as well as other system administrator functions. It contains 
both descriptive information and step-by-step instructions. 

Chapter Contents 


Launch Interact from the Shell 18 

Startup Program 19 

Configure the Display Type 23 

Set System Time and Date 24 

Create and Restore Backups 28 

Security Keys 36 

Add Language Files 40 
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Launch Interact 
from the Shell 


You may launch Interact directly from the Shell. When 
the Interact runtime session is completed, you are returned 
to the Shell. 


To launch Interact from the Shell, complete the 
following steps: 

1. Select the RUN button from the Main Menu. 
The Run submenu appears. 


CIC^ MachineSholisfie// 



Interact 

Modules: PTM, AMM, GMM, HIM, MCM, RCM, 
RPM, UPM 
Drivers: DVR, MLD 
Applications: AMMEXAMP, GMMEXAMP, 
HTMEXAMP, MCMEXAMP. 
EXAMPLE, RCMEXAMP, 
RPMEXAMP, UPMEXAMP, 
256EXAMP, TUTORIAL 

(MachineLogic is not installed) 


2. Select the INTERACT button. 

Note You may also configure Interact to automatically 
load when the runtime workstation is started. See 
the following topic, Startup Program, for details. 
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Startup Program 


Startup 

Program 


You may select whether Interact or the Shell will run after 
you power on the runtime workstation. You may change 
the startup program at anytime, but the change will not 
take effect until you reboot the runtime workstation. 

To configure the Startup Program, complete the 
following steps: 

1. Select the GENERAL button from the Settings 
submenu. 


The General Settings screen appears. Note that if you 
have the MLSC installed, the MachineLogic entry 
says MLSC rather than MLPC. 


CIC^ MachineShopsfttw 


HELP 



GENERAL SETTIUCS 


POWER W OPERATION 

SUrttA Pr«sr4ii: SHELL 
HochlncLotJc; RUN (UPC) 


Ol$pl^ Type: COLOR 


2. Select the STARTUP PROGRAM button. 
The submenu appears. 


CTC^ MachineShopsfteff 
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3. Select one of the following buttons: 

• INTERACT - Interact is automatically loaded 
without interaction from the user when you re¬ 
boot the runtime workstation. When you exit In¬ 
teract, the Shell Main Menu is displayed. This 
selection is useful if a power cycle should occur 
because the runtime workstation would automat¬ 
ically run Interact when the power is restored. 

• SHELL - The Shell is loaded and the Shell Main 
Menu is displayed when you reboot the runtime 
workstation. 

Enabling Normally you want MachineLogic to run when you 
MachineLogic reboot the runtime workstation. Sometimes, however, 
such as when you are troubleshooting, you do not want 
MachineLogic to run. Use this menu option to control 
how MachineLogic behaves when the runtime worksta¬ 
tion is rebooted. 

To enable and disable MachineLogic when you reboot 
the runtime workstation, complete the following steps: 

1. Select the GENERAL button from the Settings 
submenu. 

The General Settings screen appears. Note that if you 
have the MLSC installed, the MachineLogic entry 
says MLSC rather than MLPC. 



2. Select the MACHINELOGIC button. 

The MachineLogic submenu appears. If you have the 
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Startup Program 


MLPC (MachineLogic PC Control) installed, the 
submenu looks like the following: 



If you have the MLSC (MachineLogic Slot Card) 
installed, the submenu looks like the following:. 


CIC^ MachineShoa £/)•// 


G£HEIML SETTIHGS 

POWER on OPERATlOn 

Startup P7>3Cr«i: SICLL 

n«:Mn«Lotic: Run noK. <nLSC) 




im 

r 





3. For the MLPC, select one of the following buttons: 

• RUN - The MachineLogic runtime kernel is auto¬ 
matically loaded (warm start) and executed when 
you reboot the run-time system. 

• DO NOT RUN - The MachineLogic runtime ker¬ 
nel is NOT loaded and is NOT executed when 
you reboot the runtime workstation. 

Note The Shell modifies the MACHLOG.INI file based 
on the selection. See Appendix A for details on the 
MACHLOG.INI file. 
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For the MLSC, select one of the following buttons: 

• RUN MODE - The MachineLogic runtime ker¬ 
nel enters run mode when you reboot the runtime 
workstation. 

• STOP MODE - The MachineLogic runtime ker¬ 
nel enters stop mode when you reboot the runtime 
workstation. 

Notes The MLSC always mns whenever you power on 
the mntime workstation. You select whether it 
enters mn mode or stop mode. 

The Shell modifies the MLSC itself. An INI file is 
not required. 
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Configure the 
Display Type 


The Shell allows you to seleet the type of display (eolor, 
monoehrome LCD, or EL) for the runtime workstation. 
This is helpful when you need to adjust the eolors on your 
display. The default setting is eolor. 

Note The Display Type option is only available for 
non-CTC workstations. 

To configure the display type, complete the following 
steps: 

1. Select the DISPLAY TYPE button from the General 
Settings menu. 

The Display Type submenu appears. Note that if you 
have the MLSC installed, the MachineLogic entry 
says MLSC rather than MLPC. 


CIC™ MachineShopsfaiff 



2. Select one of the following buttons: 

• COLOR - supports 16-color VGA or 256-color 
Super VGA 

• MONO - supports 16-shade (Black & White) 
Monochrome 

• EL - supports 16-shade Electroluminescent 
Monochrome 
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Set System 
Time and Date 

Setting the Time 


The MachineShop Shell allows you to reset the runtime 
workstation time and date. 


To reset the runtime workstation time, complete the 
following steps: 

1 . Seleet the TIME/DATE button from the General 
Settings menu. 

The Time/Date submenu appears. 


CTC^ MachineShop 


HELP 





GEICRAL SCTTIHGS 

POWER OH CPEMTIOH 

StarUiP Profrmi IHTEMCT 
-- -- 


hlMLoflc: Rtfl <HLPC) 


OltPia/ Type: COLOR 



2. Select the TIME button. 

The Time keypad appears with the Current Time 
displayed. 


CIC^ MachineShop 



Note Time is recorded as hours, minutes, and seconds 
in 24-hour style. For example, the time shown in 
the illustration above, 15:46:49, is 3:46:49 p.m. 
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Setting the Date 


3. If you want to reset the system time, use the keypad to 
enter the new time in the blank field. Enter hours, 
minutes, and seconds, separating each element with a 
colon. Remember to use 24-hour style. 



Note You needn’t use zeroes in single-digit entries. For 
example, you can enter 02:05:05 as 2:5:5. Use the 
BACK button to erase any part of your entry. You 
can exit to the General Settings menu at any time 
by selecting ESC on the keypad, or by pressing 
the Esc key on your keyboard. 

4. When you have entered the new time setting, select 
ENTER on the touchscreen, or press the Enter key 
on your keyboard. 

To reset the runtime workstation date, complete the 

following steps: 

1. Select the TIME/DATE button from the General 
Settings menu. 
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The Time/Date submenu appears. 



2. Seleet the DATE button. 

The Date keypad appears with the Present Date 
displayed. 
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3. If you want to reset the system date, use the keypad to 
enter the new date in the blank field. Enter the month, 
day, and year, separating each element by a slash (/). 


CIC^ MachineShops/ww 



Note You needn’t use zeroes in single-digit entries. For 
example, you can enter the date used in the 
example above, March 1, 2001, as 3/1/01. You 
need only use the last two digits for year 2000 
dates and higher. Use the BACK button to erase 
any part of your entry. You can exit to the General 
Settings menu by selecting ESC on the keypad, or 
by pressing the Esc key on your keyboard. 

4. When you have entered the new date setting, select 
ENTER on the touchscreen, or press the Enter key 
on your keyboard. 
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Create and 
Restore 
Backups 


Creating a Backup 


A backup contains all of the necessary files for one partic¬ 
ular project on one particular runtime workstation. To 
save space, these files are compressed into a collection of 
files with predefined names. Projects are compressed into 
a subdirectory with the same name as the project. Below 
is an example of the backup directory structure. 

<Backup Path>\ 

<Project Name>\ 

$app$.zip 
$itr$.zip 
$ml$.zip 
$ml-app$.zip 
$ms$.zip 
control. XXX 

By backing up your project, you can later restore the 
entire project to the runtime workstation. When the 
project is restored, all of the fdes in the compressed 
project are automatically extracted. 

You may select one of three pre-configured paths as the 
subdirectory location for performing the backup. 

To back up a project loaded on the workstation, 
complete the following step: 

1 . Select the BACKUP button from the Utilities 
submenu. 

The Backup Projects screen appears: 


CiC^ MachineShopsfte// 


HELP 



BACKUP PROJECT 

BACKUP PATHS 
PATH 1: C:\backup 
PATH 2: a: 

PATH 3: 


28 


MachineShop Shell Runtime Guide 




Chapter 3: System Administrator Functions 


Create and Restore Backups 


The paths are shown in the display area. These paths 
are eonfigured under the “Configure Paths” option. 

Note If you have not configured a backup path, or need 
to edit a path, see Configuring a Project Backup 
Path on page 30 for instructions. 

2. Select one of the PATH buttons from the Backup 
menu. 

A confirmation pop-up appears. 



3. Select the OK button to begin the backup of the 
project in the subdirectory path. 
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The status screen appears. 

CIC^ MachineShopsfte// 



BACKUP PROJECT 


BACKING UP PROJECT Saaple 
TO: C:\backup 



Note If you have the MLSC installed, you should copy 
the project files from the MLSC to the worksta¬ 
tion prior to performing the backup. This is 
because the files on the MLSC may be different 
than those on the runtime workstation. To copy 
the project files, select MachineLogic from the 
Utilities menu, select Project Files, and then 
select Copy From Slot Card. 

4. You may abort the backup operation at anytime by 
selecting the CANCEL button from the status screen. 

Note If a problem occurs during the backup, an error 
message will be displayed on the screen. 

5. Select the OK button when the backup operation has 
finished. 

Configuring a Project Backup Path 

Before you backup the loaded project from the runtime 
workstation, you may need to configure or edit the backup 
path. The backup path is the subdirectory where the 
compressed project is stored. 
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You may configure up to three paths. 

Note A keyboard is required to input a path setting. 

Only valid DOS characters can be used for a path 
setting. The [DELETE], [HOME], [END], 
[BACKSPACE], [LEET ARROW] and [RIGHT 
ARROW] keys are supported for editing the path. 

To configure a project backup path, complete the 
following steps: 

1 . Select the CONFIGURE PATHS button from the 
Backup menu. 

The Configure Path submenu appears. 

CIC^ MachineShopsfte// 


HELP 



2. Select one of the PATH submenu buttons (1,2, or 3). 
The backup path entry screen appears. 



3. Enter the backup path using an attached keyboard. 
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4. Select the OK button to accept the path configuration. 

Note A backup path cannot be verified until an actual 
backup is performed. If there is a problem during 
the backup operation, an error message will be 
displayed on the screen. 

Restoring a Project When a project is restored, the project files are retrieved 

from the compressed backup and loaded into the runtime 
workstation. 

You may select one of three pre-configured paths as the 
subdirectory for performing the restoration. 

To restore a project, complete the following step: 

1 . Select the RESTORE button from the Utilities 
submenu. 

The Restore Project screen appears. 


CIC^ MachineShojisfie// 



The paths are shown in the display area. These paths 
are configured under the Configured Paths option. 

Note If you have not configured a restoration path, or 
need to edit a path, see Configuring a Restoration 
Path on page 34 for instmctions. 

2. Select one of the PATH buttons. 

A menu of compressed projects for the selected path 
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appears. 
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PATH 3 


Pf)TH 2: c:\backup\tiBetest 
PATH 3: 


CCMFIGURE 
- PATHS - 


3. Select the project to restore from the menu. 

A confirmation pop-up appears. 

4. Select the OK button to begin the restoration from the 
displayed path. 

Note If you have a project loaded on the workstation, a 
pop-up will appear to notify you that your current 
project will be erased. Select OK to continue the 
restoration. 

Note If you have the MLSC installed, restoring a 

project extracts the project files to the runtime 
workstation but does not transfer them to the 
MLSC. After performing a restore you should 
then copy the project files to the MLSC. To copy 
the files, select MachineLogic from the Utilities 
menu, select Project Files, and then select Copy 
To Slot Card. 
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A status screen appears. 



5. You may abort the restore operation at any time by 
selecting the CANCEL button from the status screen. 

Note If you abort the restore operation, there will be no 
project loaded on the workstation. 

On success, a pop-up appears asking if you wish to 
reboot the workstation. 

6. Select the YES button to allow changes to take effect. 

Configuring a Restoration Path 

Before you restore projects files to the runtime worksta¬ 
tion, you may need to configure or edit a restoration path. 
This is the subdirectory where the archived project is 
stored. You may configure up to three restoration paths. 

Note A keyboard is required to input a path setting. 

Only valid DOS characters can be used for a path 
setting. The [DELETE], [HOME], [END], 
[BACKSPACE], [LEET ARROW] and [RIGHT 
ARROW] keys are supported for editing the path. 
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To configure a restoration path, complete the 
following steps: 

1 . Select the CONFIGURE PATHS button from the 
Restore menu. 

The Configuration Paths submenu appears. 

2. Select one of the PATH submenu buttons (1,2, or 3). 
The restore path entry screen appears. 


CIC^ miicliineShopsfte// 


HELP 



3. Enter the restore path using an attached keyboard. 

4. Select the OK button to accept the configuration path. 

Note A restoration path cannot be verified until an 
actual restoration is performed. If there is a 
problem during the operation, an error message 
will display. 
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Security Keys 


The Shell allows you to program your Seeurity Key. You 
may enable individual key options or transfer seeurity key 
options between keys. The Shell also displays seeurity 
key information (Serial Number and Key Number) and 
installed module information for the seeurity key(s) 
attached to the workstation. 


To display security key information, complete the 
following step: 

• Select the SECURITY KEY button from the Utili¬ 
ties submenu. 


The Security Key screen appears. 
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SECURITY KEY 11 


Serial number: 33191-10110-84601 
Key number: 21184 


Module 

Config 

Runtime 

PTM 

Enabled 

Enabled 

GMM 

Enabled 

Enabled 

AMM 

Enabled 

Enabled 

RCM 

Enabled 

Enabled 

DTM 

Enabled 

Enabled 

HTM 

Enabled 

Enabled 

UPM 

Enabled 

Enabled 

RPM 

Enabled 

Enabled 

MCM 

Enabled 

Enabled 

0AM 

Enabled 

Enabled 

MBIOS 

Enabled 

Enabled 

IMD 

Enabled 

Enabled 

CAO 

Enabled 

Unused 


The Shell automatically scans and detects if a security key 
is attached to the workstation. If a key is detected, the 
display area shows the serial and key number, the Interact 
modules, and the features that are enabled in the Runtime 
Key. The display area also lists the module’s acronym 
followed by its status: Runtime, Config, or Transferred. 

Note If you have a second security key, you can view 
security key information and installed module 
information for that security key by selecting the 
VIEW KEY #2 option from the Security Key 
screen. 

Note On PA PowerStations, Enable Module is the only 
available option. 
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Enable Software When you order additional software, you will reeeive a 
Options Module Enable Code Certifieate listing enable eodes for 
eaeh software option purehased. These enable eodes are 
used to aetivate the respeetive software options on the 
Seeurity Key. 

To enable software options, complete the following 
steps: 

1. Seleet the ENABLE button from the Seeurity Key 
menu. 

The pop-up keypad appears. 

2. Enter a valid 8-digit eode for the seleeted module on 
the keypad. 

3. Seleet the ENTER key to aecept the eode. 

If the eode is valid, the module will be enabled and the 
status will be updated in the display area. If the enable 
eode is invalid, an error message will be displayed. 


Transfer Enabled 
Options Between 
Keys 


Enabled software options may be transferred from one 
key to another. You must have two keys in order to 
transfer enabled options and you may not transfer a 
module to another key that has the same module enabled. 


Note Once an option has been transferred, it may be 
moved to its original key only. 


To transfer options from one security key to another, 
complete the following steps: 

1. Select the TRANSEER MODULE button from the 
Security Key menu. 
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The Transfer Module submenu appears. 
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DTiT 

bnauisa— 

—Enauisa 

HIM 

Enabled 

Enabled 

UPM 

Enabled 

Enabled 

RPM 

Enabled 

Enabled 

MCM 

Enabled 

Enabled 

0AM 

Enabled 

Enabled 

MBIOS 

Enabled 

Enabled 

IMD 

Enabled 

Enabled 

CAD 

Enabled 

Unused 


2. Seleet one of the following buttons: 

• FROM KEY #1- Transfers an enabled module 
from the first key to a seeond attaehed seeurity 
key. 

• TO KEY #1- Transfers an enabled module from 
the seeond key to the first seeurity key attaehed to 
the runtime workstation. 

The menu of available modules appears. 


CIC^ MachineShoii sheii 



3. Seleet a module you want to transfer from the list of 
available modules. 
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Use the Next button on the menu to view additional 
modules. 

The Transfer Type submenu appears. 


CIC^ MachineShopsfte// 
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SECURITY KEY t1 

Serial number: 32191-10110-84601 
Key number: 21184 



UPM 

Enabled 

Enabled 

RPM 

Enabled 

Enabled 

MCM 

Enabled 

Enabled 

0AM 

Enabled 

Enabled 

nBios 

Enabled 

Enabled 

IMD 

Enabled 

Enabled 

CAD 

Enabled 

Unused 


4. Seleet one of the following buttons: 

• CONFIG - Transfers the eonfiguration eompo- 
nent of the Interact module. 

• RUNTIME - Transfers the runtime component 
of the Interact module. 

• DEVELOPMENT - Transfers both the configu¬ 
ration and runtime components of the Interact 
module. 

If there are any problems with the module selection or 
transfer, an error message will be displayed. 
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Add Language 
Files 


You may choose the language used by the Shell to display 
screen text and online help. The language availability 
depends on the installed language files that are detected 
by the Shell. 

The text for the Shell is stored in two files: PSU.TXT and 
PSU.HLP. The PSU.TXT file contains the menus and 
screen text, and the PSU.HLP file contains the help text. 

To add your own language file to the workstation, 
complete the following steps: 

1. Enter MS-DOS mode. 

2. Copy the screen text file (PSU.TXT) and the online 
help file (PSU.HLP) to PSULANG.XXX and 
PSUHELP.XXX respectively. 

XXX is an arbitrary extension. It is helpful to use an 
extension that indicates the language. 

3. Open the PSULANG file. 

An example of a PSULANG file is shown below. 

<npplication> 

<Hane>Teflon</Hane> 

<Connent>The Non-Stick Shell</Connent> 

<Uersion>EX-83O73-100f</Uersion> 

<Language>French</Language> 

</Application> 

- <S t ri ng g> -^ 

<Text ID="ie01">ERROR: Insufficient graphical capability.</Text> 

<Text ID="1OO2">ERR0R: Unable to setup graphics node.</Text> 

<Text ID="1083">ERROR: Could not find a ualid mouse driver.</Text> 

<Text ID="1004">ERROR: Mouse initialization failed.</Text> 

<Text ID="1O05">ERROR: Application initialization failed.</Text> 

<Text ID="1O06">ERROR: Invalid filename.</Text> 

<Text ID="1OO7">ERR0R: Memory allocation failure.</Text> 

<Text ID="1OO8">ERR0R: XML parser general failure.</Text> 

<Text ID="1809">ERR0R: Invalid Arguments.</Text> 

<Text ID="1010">ERROR: Cannot open file.</Text> 

<Text ID="1011">ERROR: Error while reading from file.</Text> 

<Text ID="1O12">ERR0R: Invalid XML format encountered.</Text> 

4. Enter the language that the file contains at the 
Language parameter (in the Application section). 

Eor example, if the language is Erench then the 
parameter would be as follows: 

<LANGUAGE>ERENCH</LANGUAGE> 

5. Translate the text located between each XML Text 
start-tag and the corresponding XML Text end-tag. 

Lor example, translate the following string: 
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<Text ID="1688">Note enough keys found for 
transfer,</Text> 

where <Text ID=“1688”> is the XML start-tag and </ 
Text> is the XML end-tag. 

If the language is Freneh, the string looks like the 
following: 

<Text ID="1688">Pas assez de cles ont trouve pour 
le transfert.</Text> 

6. Save the ehanges and elose the file. 

The Language submenu will display the new 
language when the Shell is loaded. 

7. Open the PSUHELP file and repeat steps 4-6. 

8. Start the Shell and seleet the language from the 
Language submenu. 

All screen text and online help will be displayed in the 
selected language. 

Note The Shell will load the first occurrence of the 
language files if duplicate language names are 
found. 
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Maintaining the 
PowerStation 

This chapter will show you how to use MachineShop Shell to cali¬ 
brate the touchscreen, perform a keyboard test, adjust the bright¬ 
ness and contrast levels of the PowerStation display, and configure 
the Shift and Select keys on a P5 PowerStation. 

If you are not running the Shell on a PowerStation, you may skip 
this chapter. 
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Calibrate the 
Touchscreen 


The PowerStation’s touehsereen is ealibrated prior to 
being shipped from CTC. However, you may need to 
reealibrate the touehsereen when you begin using the 
PowerStation for the first time or whenever the eursor 
loeation and the loeation on the sereen where the user 
touehes do not mateh. 


To calibrate the touchscreen, complete the followings 
steps: 

1 . Select the POWERSTATION button from the 
Settings submenu. 

The PowerStation Settings screen appears. 


CIC^ liielilneShopsfte// 





2. Select the CALIBRATE TOUCHSCRN button. 
The calibration routine will run automatically. 

3. Use your finger to touch the + on the screen. 
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Perform a 
Keyboard Test 


4. Repeat the previous step two more times. Eaeh time 
you toueh the + you will hear a faint beep to indicate 
that the touch has been accepted. 

After the third time, your touchscreen will be cali¬ 
brated. 

Important If you calibrated the touchscreen and the cursor 
moves vertically when your finger moves hori¬ 
zontally on the screen or vice versa, the touch¬ 
screen cable may not be connected to the 
motherboard properly. Call a CTC customer 
support representative. 


You may test the keyboard connected to the PowerStation 
by selecting the Keyboard Test option from the PowerSta¬ 
tion Settings menu. 

To test the keyboard, complete the following steps: 

1. Select the PWRSTA button from the Settings 
submenu. 

The PowerStation Settings screen appears. 

CIC^ MachineShopsfte// 


HELP 


PoverStation SETTINGS 

DISPLAY 
Brightness: 8 
Contrast: 14 


2. Select the KEYBOARD TEST button. 
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The Keyboard Test sereen appears. 

CIC^ MachineShoisfie// 



3. Press any key on the keyboard. 

The PowerStation will display the text string in the 
Key Press field. Confirm that the text string matehes 
the pressed key. 
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Adjust the 
Brightness 
Level 


4. To exit the keyboard test, seleet the ESC button or 
press the ESC key twiee. 


You may manually ehange the brightness level of the 
PowerStation touehsereen display. You ean either 
Deerease or Inerease the screen brightness. 

Note This option is not available for all PowerStations 
or touchscreen displays. 

To adjust the brightness level of your display, 
complete the following steps: 

1. Select the PWRSTA button from the Settings 
submenu. 

The PowerStation Settings screen appears. 
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PoverStation SETTINGS 


DISPLAY 
Brightness: 8 
Contrast: 14 


2. Select the ADJUST BRIGHT button. 

Note This option may not be available depending on the 
PowerStation or display type. 
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The Adjust Brightness submenu appears. 
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3. Seleet one of the following buttons: 

• DECREASE - deereases the sereen brightness 

• INCREASE - inereases the sereen brightness 

Eaeh eliek on a seleetion will inerease or deerease the 
brightness setting by one. 


Adjust the 
Contrast Level 


You may manually ehange the eontrast level of the 
PowerStation touehsereen display. You ean either 
Deerease or Inerease the screen contrast. 


Note This option is not available for all PowerStations 
or touchscreen displays. 

To adjust the contrast level of your display, complete 
the following steps: 

1 . Select the PWRSTA button from the Settings 
submenu. 
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The PowerStation Settings sereen appears. 


CiC^ IdicliineShDpsfte// 



CALIBRATE 


TOUCHSCRH 


DISPLAY 
Brightness: 8 
Contrast: 14 


■QOH 

liLliliLI 


2. Seleet the ADJUST CONTRAST button. 

Note This option may not be available depending on the 
PowerStation or display type. 

The Adjust Contrast submenu appears. 

CIC^ IdicliineShDpsfte// 


HELP 



MachineShop Sheii Runtime Guide 


49 




Configure the Shift Key 


Chapter 4: Maintaining the PowerStation 


3. Select one of the following buttons: 

• DECREASE - decreases the screen contrast 

• INCREASE - increases the screen contrast 

Each click on a selection will increase or decrease the 
contrast setting by one. 


Configure the 
Shift Key 


You may manually change the configuration of the Shift 
key, located on the faceplate of the P5 PowerStation. 

Note This option is only available for P5 PowerSta- 
tions. 


To configure the Shift key on your PS PowerStation, 
complete the following steps: 

1 . Select the PWRSTA button from the Settings 
submenu. 

The PowerStation Settings screen appears. 



2. Select the KEY CONEIG button. 
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The Key Configuration sereen appears. 
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3. Seleet SHIFT OPERATION. 

The Shift Operation submenu appears. 

CIC^ IdiciiineShDpsfte// 
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4. Seleet one of the following buttons: 

• MOMENTARY - When you press and hold the Shift 
key, you have aeeess only to the F21-F40 function 
keys. When you release the Shift key, you automati¬ 
cally regain access to FI through F20. 

• LOCK - When you press the Shift key, it locks, 
allowing access only to the F21 through F40 function 
keys. To regain access to FI through F20, you must 
press the Shift key again to release the lock. 

• LOCK/RELEASE - When you press the Shift key, 
it locks, allowing access to F21 through F40, only 


MachineShop Sheii Runtime Guide 


51 




Configure the Select Key 


Chapter 4: Maintaining the PowerStation 


Configure the 
Select Key 


until you press and release any other key. 

Note An indicator on the faceplate is lit whenever the 
Shift key is activated or in the locked mode. 


You may configure the Select key that appears on the 
faceplate of the P5 PowerStation, so that while you are in 
Interact, it acts as the key of your choice. 

Note This option is only available for P5 PowerSta- 
tions. 


To change the configuration of the Select key on your 
PS PowerStation, complete the following steps: 

1 . Select the PWRSTA button from the Settings 
submenu. 

The PowerStation Settings screen appears. 
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PowerStation SETTINGS 


DISPLAY 
Brightness: 8 
Contrast: 14 


2. Select the KEY CONFIG button. 
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The Key Configuration sereen appears. 
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KEY CONFIGURATION 

Shift Node: Momentary 
Selection Key: Rt Shift 


3. Seleet the SELECTION KEY button. 
The Seleetion Key submenu appears. 


CIC^ MwttnntShao Shell 
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4. Choose a keyboard key from the submenu. The Seleet 
key on the P5 PowerStation faeeplate will aet like the 
key you have ehosen, while you are in Internet. The 
following seleetions are available: Right Shift 
(default), Left Shift, Ctrl, Alt, FI through FIO, and 
Keypad +. 
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Preparing for Transfers 

The Shell is used by the runtime workstation to receive Interact 
and MachineLogic files transferred from a development system 
running the MachineShop Toolbar. This chapter describes how to 
prepare the Shell for file transfers. It includes setting up a Direct 
Serial, serial PPP, LAN, and an Ethernet point to point connection. 

This chapter also includes instructions on how to download 
projects to the runtime workstation and create remote backups 
using the MachineShop Toolbar. For a more complete discussion 
on MachineShop, refer to the MachineShop Getting Started 
Guide. 
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Configure the 
TCP/IP Settings 


MachineShop (the Shell and Toolbar) uses the industry 
standard TCP/IP protocol to communicate over Ethernet, 
serial PPP, and internet connections. 

Use the TCP/IP settings to configure the various Ethernet 
ports (or connections) in the runtime workstation. You 
can use these connections to communicate with the devel¬ 
opment system and for other purposes such as communi¬ 
cating with I/O. 

The TCP/IP settings include the IP address, IP mask, host 
name, port address, IRQ, and baud rate for serial PPP 
connections. These settings must be configured before 
you can transfer files between the runtime and develop¬ 
ment systems. 

To access the TCP/IP settings, complete the following 
step: 

1 . Select the TCP/IP button from the Settings submenu. 
The TCP/IP Setup screen appears. 



Note Changes made to the TCP/IP Settings are written 
to the TCPIP.INI file located in the NET direc¬ 
tory. Changes do not take effect until the mntime 
workstation reboots. A confirmation message will 
display when you exit the TCP/IP Setup screen 
asking if you wish to reboot the runtime worksta¬ 
tion. 
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Enabling TCP/IP 


Configure a 
MachineShop Net 
Name 


TCP/IP must be enabled (loaded into memory) on the 
runtime workstation in order for eommunieation to oeeur. 

To enable and/or disable the TCP/IP network, 
complete the following steps: 

1. Seleet the ENABLE button from the TCP/IP Setup 
menu. 

The Enable TCP/IP submenu appears. 


CIC^ liiciiineSliD»s>n/f 



2. Seleet one of the following buttons: 

• YES - ehanges the TCPIP.INI file and loads the 
TCP/IP staek into memory at startup. 

• NO - ehanges the TCPIP.INI setting so that 
TCP/IP networking is disabled. 

The MaehineShop Net Name is used by MaehineShop 
and the development systems to identify the runtime 
workstations on a network. Onee you assign a Net Name 
to your runtime workstation, the Net Name is periodieally 
broadeast over the network using the network’s DHCP 
eapabilities. The development system reeeives this broad- 
east and identifies the runtime workstation by its IP 
address, whieh is ineluded in the Net Name broadeast. 

To configure the MachineShop Net Name, complete 
the following steps: 

1. Select the NET NAME button from the TCP/IP Setup 
menu. 
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Configure the 
Connection 


The MachineShop Net Name entry sereen appears. 

CIC^ 


HELP 

BACK 

ENABLE 


NET SEW 


MET NAME 


IWacliineShDiisfte// 


TCPIP SETUP 



2. Enter a name in the entry sereen. 

The name has a limit of eight eharaeters and should be 
unique to a network. 

3. Seleet the OK button to aeeept the new name. 


The Net Setup option from the TCP/IP Setup menu is used 
to define and eonfigure the network eonneetion. 

To configure the network connection settings, 
complete the following step: 

1 . Select the NET SETTINGS button from the TCP/IP 
Setup menu. 

The TCP/IP Network Setup screen appears. 


CIC^ MachineShop 5fte// 


HELP 


TCPIP NETWORK SETUP 

MET 1 

IP Address: DHCP (172.25.8.41) 
IP Mask: 255.255.255.0 
Interface: ME2000 
IRQ: 4 
Port: 3F8h 

MET 2 (DOWNLOAD ONLY) 

IP Address: 10.0.0.2 

IP Mask: 255.255.255.0 
Interface: Serial 
IRQ: 4 
Port: 3F8h 
Baud: 115200 

NET 3 

Not Configured. 
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The display area of the sereen shows the eurrent 
network eonneetion settings. Speeific settings for 
eaeh eonneetion are based on the installed Network 
Interface Cards. 

2. Select one of the NET buttons (1, 2, or 3) from the 
Network Setup menu. You can select any of the 
buttons for your connection. For example you do not 
have to select Net 1 for your first connection. 

The Net submenu appears. 


CIC^ MachineSho»5fte// 



ir ndsx: c.z>z>. cdd. 

Interface: Serial 


IRQ: 4 
Port: 3F8h 
Baud: 115208 

MET 3 

Mot Configured. 


Note Options on the Net submenu vary according to 

your interface type. If your interface type does not 
support a particular option, it is unavailable for 
selection (grayed out) on the submenu. 

Select the Interface Type 

Use the IF ACE TYPE option from the Net submenu to 
select the communication interface for your network. The 
lEACE TYPE must match the installed network interface 
card for the selected NET connection. 

To select the Interface Type for a connection, complete 
the following steps: 

1. Select the IFACE TYPE button from the Net 
submenu. 

The Interface Type submenu appears. 

2. Select one of the following buttons: 
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• DISABLE - disables the connection 

• 182557 - select this option if you have a Pentium- 
based runtime workstation. For use with all CTC- 
Parker PowerStations except the PI. 

• 3C509 - select this option if you are using a 
3COM 3C509 ISA Ethernet card 

• NE2000 - select this option if you are using a 
NE2000 compatible network interface card. Eor 
use with a PI PowerStation. 

• Serial PPP - select this option if you are using a 
serial port 

• ODI - select this option if you are using NetBIOS 
networking with Interact’s NBIOS driver 

• PACKET - select this option if you are using a 
packet driver with your network interface card. 

Note Be sure to edit AUTOEXEC.BAT to launch the 
packet driver itself. You must specify a software 
interrupt for the packet driver. The software inter¬ 
rupt value you specify in the TCP/IP settings must 
match the value you use in AUTOEXEC.BAT. 

Note Eor the PA PowerStations, the only available 
IP ACE TYPES are ODI and 182557. 

• MLSC - When the MachineEogic Slot Card is 
detected on your runtime workstation, this option 
is automatically selected for you. 

The Interface Type submenu closes and you return to the 
TCP/IP Network Setup screen. 

Enter an IP Address 

Use the IP ADDRESS option from the Net submenu to 
configure the IP Address for the connection. The IP 
Address is a unique address that identifies the runtime 
workstation to the network (using the TCP/IP protocol). It 
consists of two parts: a network number and a host 
number. 
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Configure the TCP/IP Settings 


Check with your local network administrator to determine 
a valid IP Address to be used on your local network. 

To configure the IP Address, complete the following 
steps: 

1. Select the IP ADDRESS button from the Net 
submenu. 

The IP Address entry pop-up appears. 

2. Enter a valid IP Address in the entry field. 

An IP Address is a series of four numbers with a value 
of each number between 0 and 255 separated by 
periods (for example, 10.0.0.2). 

Enter O.O.O.O if your network has Dynamic Host 
Configuration Protocol (DHCP) support. DHCP 
dynamically assigns IP addresses to workstations as 
needed. 

Note You can enter the number by using your keyboard 
or by using the on-screen keypad. 

3. Click the OK button to accept the value. 

The pop-up closes and you return to the TCP/IP Network 
Setup screen. 

Enter an IP Mask 

Use the IP MASK option from the Net submenu to 
configure the IP Mask for the connection. The IP Mask is 
a locally-defined subset of IP Addresses used to identify a 
smaller group within a network. Each network must have 
a mask even if there are no subnets on the network. The 
mask is applied to the IP Address in every message in 
order to separate the network number and the host 
number. 

The IP Mask uses the same format as an IP Address. 
Check with your network administrator to obtain a valid 
IP Mask for your local network. 

To configure the IP Mask, complete the following 
steps: 
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1 . Select the IP MASK button from the Net submenu. 
The IP Mask entry pop-up appears. 

2. Enter a valid IP Mask value in the entry field. 

An IP Mask is a series of four numbers with a value 
between 0 and 255, separated by periods (for 
example, 255.255.255.0). The first number is always 
255. 

3. Click the OK button to accept the value. 

The pop-up closes and you return to the TCP/IP Network 
Setup screen. 

Specify the Port Address 

Use the PORT ADDRESS option from the Net submenu 
to configure the I/O Port Address for the selected network 
connection. 

To specify the Port Address for the network interface 
or COM port, complete the following steps: 

1. Select the PORT ADDRESS button from the Net 
submenu. 

The pop-up keypad appears. 

2. Enter a valid I/O Port Address for the selected 
connection. 

Eor serial ports, C0M1=3P8, COM2=2P8, 
COM3=3E8, and COM4=2E8 

lOBase-T Ethernet Port=280 

3. Select the ENTER button to accept the value. 

The pop-up keypad closes and you return to the TCP/IP 
Network Setup screen. 

Select the Baud Rate 

Use the BAUD RATE option from the Net submenu to 
select the communication speed used by the COM port to 
transfer data. This must match the baud rate set in the dial¬ 
up properties for the specific connection. 
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Configure the TCP/IP Settings 


To select the baud rate for the serial PPP connection, 
complete the following steps: 

1. Select the NET button from the TCP/IP Network 
Setup menu. 

The Network Connection submenu appears. 

2. Select the BAUD RATE button. 

A list of transfer speeds appears. 

3. Select the transfer speed from the list. 

This must match the baud rate set in the dial-up prop¬ 
erties for the specific connection. 

The list of transfer speeds closes and you return to the 
TCP/IP Network Setup screen. 

Note If you have reliability problems using the selected 
baud rate, try selecting a slower baud rate. 

Set the Hardware IRQ 

Use the IRQ / INTERRUPT option from the Net submenu 
to set the hardware IRQ used by the network interface or 
COM port. The assigned IRQ number must match the 
hardware jumper settings for proper operation of the port. 

To configure the IRQ for the connection, complete the 
following steps: 

1. Select the IRQ / INTERRUPT button from the Net 
submenu. 

The Select Network Interface IRQ pop-up appears. 

2. Select the keypad number on the screen to enter the 
IRQ value. 

The value set on the keypad must match the value 
configured on the installed hardware card or COM 
port. 

For serial ports, COM 1=4, COM2=3, COM3 and 
COM4=variable setting 

Powers tation lOBase-T Ethernet Port=10 
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The pop-up keypad eloses and you return to the TCP/IP 
Network Setup sereen. 

Set the Software Interrupt 

Use the IRQ / INTERRUPT option from the Net submenu 
to set the software interrupt used by the network interfaee 
or COM port. The assigned interrupt number must mateh 
the hardware jumper settings for proper operation of the 
port. 

To configure the interrupt for the connection, 
complete the following steps: 

1 . Select the IRQ / INTERRUPT button from the Net 
submenu. 

The Select Network Interface IRQ pop-up appears. 

2. Select the keypad number on the screen to enter the 
IRQ value. 

The value set on the keypad must match the value 
configured on the installed hardware card or COM 
port. 

For serial ports, COMI=4, COM2=3, COM3 and 
COM4=variabIe setting 

Powers tation lOBase-T Ethernet Port=I0 

The pop-up keypad closes and you return to the TCP/IP 
Network Setup screen. 

Set to Download Only 

The Download Only option applies only to serial connec¬ 
tions and is used to keep the port from initializing until the 
Shell is loaded. This allows other programs (such as 
Interact) to use the selected connection once you exit the 
Shell. If you do not enable Download Only for the 
connection, TCP/IP will communicate over the network 
interface or COM port even when the Shell is not loaded. 

Because other programs (such as Interact and MachineE- 
ogic) may use the serial port hardware, you may need to 
indicate that the serial port cannot be assigned exclusively 
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Configure the TCP/IP Settings 


Entering an Internet 
IP Address 


to the TCP/IP PPP connection. If you are using the serial 
port for Interact or MachineLogic, then you must enable 
Download Only. If the serial port is to be used exclusively 
as a PPP connection, then disable Download Only. 

You can toggle between enabling and disabling the 
Download Only option. 

To enable/disable Download Only, complete the 
following step: 

• Select the DOWNLOAD ONLY button from the 
Net submenu. 

The MachineShop Shell allows you to configure your 
TCP/IP settings so that you can transfer projects over the 
Internet. You can assign an Internet address by using the 
Gateway option in your TCP/IP Network settings. 

Note If your runtime workstation is using a Dynamic 
Host Configuration Protocol (DHCP) address 
assigned by your server, MachineShop will ignore 
a Gateway IP address. You can only use a 
Gateway address if your workstation uses a static 
IP address. 

To assign a Gateway IP address, complete the 
following steps: 

1. From the TCP/IP Network Setup screen, select NET 

1 . 

The Net submenu appears. 
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Restrict Access 
to Files 


CIC^ MicliineSliDBsfie// 



Note The Shell check Netl first, Net2 second, and Net3 
last. The first Gateway it finds is the one it uses. 

2 . Select the GATEWAY button. 

The Gateway dialog box appears. 

3. Enter the Gateway IP address in the space provided. 

Note See your network administrator for a valid IP 
address. 

4. Select the OK button to accept the new address. 

The FTP option from the Settings menu allows you 
restrict access to the files on the runtime workstation. 
FTP, or File Transfer Protocol, is the method by which 
you transfer project files from a development system on a 
network to a runtime workstation on the same network. 

The FTP settings include a User Name and Password and 
are required to perform project transfers. The User Name 
is used to identify the name of the user that will transfer 
files to or from the workstation. The Password allows 
users access to the download capabilities of the worksta¬ 
tion. 

By default, these settings are blank. If you would like to 
restrict access to the files on the workstation, simply enter 
an FTP User Name and Password. 

To add an FTP user name and password, complete the 
following steps: 
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1. Select the FTP button from the Settings menu. 
The FTP Setup screen appears. 



The display area of the screen shows the current FTP 
User Name. 

2. Select the USER NAME button from the FTP Setup 
menu to enter a user name. 

The FTP user name entry screen appears. 



3. Enter a user name in the entry field. 

The user name has a limit of ten characters. 

4. Select the OK button to accept the value. 

5. Select the PASSWORD button from the FTP Setup 
menu to enter a password. 
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The FTP password entry sereen appears. 


CIC^ IdiclimeShDpsfte// 



Note If you have an existing password, you will be 

asked to enter the old password first. If you forget 
your password, open the PSU.CFG file and delete 
the password entry. You must then enter a new 
password. 

6. Enter the password in the entry field. 

The Password has a limit of 20 eharacters and is ease 
sensitive. 

7. Seleet the OK button to aeeept the value. 

A eonfirmation pop-up appears. 

8. Enter the password again to eonfirm the new pass¬ 
word. 
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Direct Serial 
Connection 


A Direct Serial connection is one in which a serial port on 
the development system is connected to a serial port on 
the runtime workstation using a null modem cable. Direct 
Serial is not a network connection, so it does not require 
any network setup in either the development system or in 
the runtime workstation. 

This option lets you transfer MachineShop project files to 
the runtime workstation. You can download and upload 
complete project files, or you can download and upload 
only the updated files you have changed. 

How fast the transfer occurs can vary. The MachineShop 
Toolbar determines the BAUD rate when you start the 
transfer. 

Notes Changes made to the Direct Serial configuration 
are written to the PSU.CFG file (see Appendix A). 
These changes take effect after you reboot the 
runtime workstation. 

The Direct Serial connection does not support 
password protection. 

To access the Direct Serial settings, complete the 
following steps: 

1. Select the Settings menu. 

C?ro™ MachineShop sfttw 


HELP 



2. Select Direct Serial. 
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Assigning a Port 


The Direct Serial Settings screen appears. 


CIC^ MachineShopsftt/f 


HELP 


DIRECT SERIAL SCTfIHGS 

Direct Serial Transfer: COHl 
<Port-3F9. IRO^> 



Configure the Direct Serial connection by assigning it to 
a port on your workstation. You can select either the 
COMl or COM2 port for your transfer. 

To select a port, complete the following steps: 

1. Select the Settings menu. 

2. Select Direct Serial. 

3. From the Port submenu, select either the COMl port 
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Direct Serial Connection 


Disabling the Direct 
Serial Connection 


or the COM2 port. 


CIC^ MachineShopsfttw 


HELP 



DIRECT SERIAL SETTINGS 



Note The Shell verifies that the port address and IRQ 
associated with the selected port is not already 
assigned to another setting within the Shell. If a 
conflict is detected, a pop-up appears giving you 
the option of continuing (in which the Shell 
removes the conflicting setting) or of trying 
another COM port. 

Disable the Direct Serial connection when the COM port 
is used for another purpose. This causes the Shell to 
ignore Direct Serial connections from the MachineShop 
Toolbar. 

Note The Direct Serial COM port acts just like PPP 

connections with Download Only selected. That 
is, the COM port can be used by other programs 
but when the Shell is running, the COM port is 
used by the Shell. When the Shell terminates, it 
returns the COM port to whatever was using it. 

To disable the Direct Serial connection: 

1. Select the Settings menu. 

2. Select Direct Serial. 
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3. From the Port submenu, seleet Disable... 



72 


MachineShop Shell Runtime Guide 



Chapter 5: Preparing for Transfers 


LAN Connection 


LAN 

Connection 


This section describes the steps you need to complete to 
prepare the runtime workstation for file transfers using a 
LAN connection. For detailed descriptions on how to 
configure the settings, see the Configure the TCP/IP 
Settings section in this chapter. 

To configure the Shell for a LAN connection, complete 
the following steps: 

1. Select the TCP/IP button from the Settings menu to 
configure the TCP/IP settings. 

2. If TCP/IP hasn’t been enabled, select the ENABLE 
button from the TCP/IP Setup menu. 

3. If a MachineShop Net Name hasn’t been configured 
for the runtime workstation, select the NET NAME 
button from the TCP/IP Setup menu and then enter a 
name. 

4. Select the NET SETUP button from the TCP/IP 
Setup menu to configure the network interface. 

5. Select one of the NET buttons (1, 2, or 3) from the 
Network Setup menu. 

6. Select the lEACE TYPE button from the Net 
submenu and then select your interface type. 

Your selection depends on the network interface card 
installed in the runtime workstation. For the lOBase- 
T port, use NE2000. 

7. Select the IP ADDRESS button from the Net 
submenu and then enter the IP Address. 

Check with your local network administrator to deter¬ 
mine a valid IP Address. 

If your network has Dynamic Host Configuration 
(DHCP) support, enter O.O.O.O as the IP Address. 
DHCP dynamically assigns IP addresses to worksta¬ 
tions as needed. 

8. Select the IP MASK button from the Net submenu, 
and then enter the IP Mask. 

Check with your local network administrator to deter- 
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mine a valid IP Mask. 

9. If your interface type supports the Port Address and 
IRQ / Interrupt options, enter a value for each. 

10. Exit the Net Setup menu. 

11. Exit the TCP/IP Setup menu and reboot the worksta¬ 
tion. 

Changes do not take effect until the runtime worksta¬ 
tion reboots. 

12. If you wish to restrict access to the files on the runtime 
workstation, enter a ETP user name and password. To 
do this, select the FTP button from the Settings menu. 

13. Connect the Ethernet cable to the Ethernet port of the 
runtime workstation. 

You are now ready to transfer files from the development 

system (running MachineShop) to the Shell. See the 

Transfer Project Files section in this chapter for details. 


74 


MachineShop Shell Runtime Guide 



Chapter 5: Preparing for Transfers 


Serial PPP Connection 


Serial PPP 
Connection 


This section describes the steps you need to complete to 
prepare the runtime workstation for file transfers using a 
serial PPP connection. For detailed descriptions on how to 
configure the settings, see the Configure the TCP/IP 
Settings section in this chapter. 


Note The COMl port on the runtime workstation is 
used only for downloading and debugging 
MachineLogic projects. 

To configure the Shell for a Serial PPP connection, 

complete the following steps: 

1. Select the TCP/IP button from the Settings menu to 
configure the TCP/IP settings. 

2. If TCP/IP hasn’t been enabled, select the ENABLE 
button from the TCP/IP Setup menu. 

3. If a MachineShop Net Name hasn’t been configured 
for the runtime workstations, select the NET NAME 
button from the TCP/IP Setup menu and then enter a 
name. 

4. Select the NET SETUP button from the TCP/IP 
Setup menu to configure the network interface. 

5. Select one of the NET buttons (1, 2, or 3) from the 
Network Setup menu. 

6. Select the lEACE TYPE button from the Net 
submenu and then select Serial as the interface type. 

7. Select the IP ADDRESS button from the Net 
submenu and then enter the IP Address. 

8. Select the IP MASK button from the Net submenu 
and then enter the IP Mask. 

9. Select the PORT ADDRESS button from the Net 
submenu and then define the COM port. 

C0M1=3F8, COM2=2F8, COM3=3E8, COM4=2E8 

10. Select the BAUD RATE button from the Net 
submenu and then select the baud rate. 

This must match the baud rate set in the MachineShop 
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Toolbar. 

11. Select the IRQ / INTERRUPT button from the Net 
submenu and then enter the hardware IRQ or software 
interrupt for the COM port. 

COMl=4, COM2=3, COM3 and COM4=variable 
setting 

12. Select the DOWNLOAD ONLY button from the Net 
submenu to keep the port from initializing until the 
Shell is loaded. 

13. Exit the Net Setup menu. 

14. Exit the TCP/IP Setup menu and reboot the worksta¬ 
tion. 

Changes do not take effect until the runtime worksta¬ 
tion reboots. 

15. If you wish to restrict access to the files on the runtime 
workstation, enter a ETP user name and password. To 
do this, select the FTP button from the Settings menu. 

16. Connect the serial cable to the appropriate serial port 
of the runtime workstation. 

You are now ready to transfer files from the development 
system (running MachineShop) to the Shell. See the 
Transfer Project Files section in this chapter for details. 

Serial PPP Cable You can use any standard Windows RAS null modem 
cable, you can construct your own cable, or you can 
purchase a cable from CTC-Parker. If you decide to 
construct you own cable, refer to the following table for 
cable pinouts. 


9-pin 

25-pin 


25-pin 

9-pin 

Description 

pin 5 

pin 7 

<- 

-> 

pin 7 

pin 5 

Ground-Ground 

pin 3 

pin 2 

<- 

-> 

pin 3 

pin 2 

Xmit-Rcv 

pin 7 

pin 4 

<- 

-> 

pin 5 

pin 8 

RTS-CTS 

pin 6, 1 

pin 6, 8 

<- 

-> 

pin 20 

pin 4 

DSR, CD-DTR 

pin 2 

pin 3 

<- 

-> 

pin 2 

pin 3 

Xmit-Rcv 
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9-pin 

25-pin 


25-pin 

9-pin 

Description 

pin 8 

pin 5 

<- 

-> 

pin 4 

pin 7 

CIS-RTS 

pin 4 

pin 20 

<- 

-> 

pin 6, 8 

pin 1, 6 

DTR-DSR, CD 
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Ethernet Point 
to Point 
Connection 


This section describes the steps you need to complete to 
prepare the runtime workstation for file transfers using an 
Ethernet point to point connection. For detailed descrip¬ 
tions on how to configure the settings, see the Configure 
the TCP/IP Settings section in this chapter. 

To configure the Shell for an Ethernet point to point 
connection, complete the following steps: 

1 . Select the TCP/IP button from the Settings menu to 
configure the TCP/IP settings. 

2. If TCP/IP hasn’t been enabled, select the ENABLE 
button from the TCP/IP Setup menu. 

3. If a MachineShop Net Name hasn’t been configured 
for the runtime workstation, select the NET NAME 
button from the TCP/IP Setup menu and then enter a 
name. 

4. Select the NET SETUP button from the TCP/IP 
Setup menu to configure the network interface. 

5. Select one of the NET buttons (1, 2, or 3) from the 
Network Setup menu. 

6. Select the lEACE TYPE button from the Net 
submenu and then select an option such as the 182557, 
3C509, or NE2000 as the interface type. 

Your selection depends on the network interface card 
installed in the runtime workstation. For the lOBase- 
T port, use NE2000. 

7. Select the IP ADDRESS button from the Net 
submenu and then enter the IP Address. 

8. Select the IP MASK button from the Net submenu 
and then enter the IP Mask. 

9. If your interface type supports the Port Address and 
IRQ / Interrupt options, enter a value for each. 

10. Exit the Net Setup menu. 

11. Exit the TCP/IP Setup menu and reboot the worksta¬ 
tion. 

Changes do not take effect until the runtime worksta- 
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Ethernet Point to Point Connection 


tion reboots. 

12. If you wish to restrict access to the files on the runtime 
workstation, enter a FTP user name and password. To 
do this, select the FTP button from the Settings menu. 

13. Connect the runtime workstation to the Ethernet 
connector using a cross-over lOBase-T cable. 

You are now ready to transfer files from the development 
system (running MachineShop) to the Shell. See the 
Transfer Project Files section in this chapter for details. 
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Transfer Project 
Files 


Adding a 
Connection 


Once you have set up the Shell on the runtime worksta¬ 
tion, project files on the development system may be 
transferred to the runtime workstation using the Machine- 
Shop Toolbar. 

This section describes how to use the MachineShop 
Toolbar to download and upload an active project from 
the development system to the runtime workstation. It 
also includes the steps for creating a remote backup. For a 
complete discussion on MachineShop, refer to the 
MachineShop Getting Started Guide or the MachineShop 
online help. 

Important Project fdes can only be transferred to the runtime 
workstation when the MachineShop Shell Main 
Menu is displayed on the screen. 

Before you can transfer files to the runtime workstation, 
you must create a transfer connection on the development 
system. A connection refers to the method used to transfer 
files to or from a runtime workstation. The types of 
transfer connections available are MachineShop Net, 
Interact IPM, Direct Serial, and disk transfer. 

In this example, we will add a MachineShop Direct Serial 
connection. This type of connection lets your develop¬ 
ment system communicate to the runtime workstation 
using a null modem serial cable. 

For instructions on the other transfer connections, refer to 
the MachineShop Getting Started Guide. 

Note If you are using an Ethernet point to point connec¬ 
tion, you will also need to configure the TCP/IP 
properties using the Network option in the 
Windows Control Panel. Refer to the Machine- 
Shop Getting Started Guide for instructions. 

To add a MachineShop Direct Serial connection on the 
development system, complete the following steps: 

1. Open MachineShop. 

2. Select the Add Connection command from the 
Transfer Menu or click the Add Connection button 
on the toolbar. 
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The New Conneetion dialog box appears. 


Add Connection 


Connection name: 


Connection type: 


MachineShoo Net ISerial/LAN 


MachineShop Net (Setial/LAN) 
Disk 

IPM Compatible (Serial)_ 


Direct Serial 


3. Enter a name for this connection. 

4. Select Direct Serial as the connection type. 

5. Click the OK button to accept these choices. 

The New Connection Wizard - Step 1 screen appears. 
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6. Select the COM port and baud rate you want to use in 
this connection. 

7. Click Finish to create the connection. 
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Uploading Files 


Once a connection is created, you may download the files 
needed to create or update the runtime workstation. The 
MachineShop Toolbar includes a Transfer Wizard that 
steps you through the process of selecting a connection 
and downloading files to a runtime workstation. 

To download files to the runtime workstation, 
complete the following steps: 

1. Open the project you wish to download in Machine- 
Shop. 

2. Select the Transfer Wizard command from the 
Transfer menu. 

The Transfer Wizard appears. 

3. Check the Download to Runtime box and then click 
on Next. 

4. Follow the instructions provided by the Transfer 
Wizard to finish downloading the project. For more 
information, refer to the MachineShop Getting 
Started Guide. 

Note If you have the MLSC installed, you may want the 
project files to also be transferred to the MLSC. 
You can set this to happen automatically as part of 
the download from the Toolbar using a selection 
in the Transfer Wizard. Or you can set the Toolbar 
to download to the runtime workstation and then, 
after the transfer is complete, download the 
project from the runtime workstation to the 
MLSC itself. For more information, see the 
Project Files section in Chapter 6. 

You may also upload a file or project to the development 
system using the Transfer Wizard. The process of 
uploading a project is very similar to downloading a 
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Remote Backup 


project. 

Important If you have the MLSC installed, you may want to 
retrieve the files from the MLSC before uploading 
them to the Toolbar. You can set this to happen 
automatically as part of the upload from the Shell 
by using the Transfer Wizard. Or you can manu¬ 
ally perform an additional step before step 1 
below to upload the project from the MLSC to the 
runtime workstation. For more information, see 
the Project Files section in Chapter 6. 

To upload files to the development system, complete 
the following steps: 

1. Select the Transfer Wizard command from the 
Transfer menu. 

The Transfer Wizard appears. 

2. Check the Upload from Runtime box and then click 
on Next. 

3. Follow the instructions provided by the Transfer 
Wizard to finish uploading the project. For more 
information, refer to the MachineShop Getting 
Started Guide. 

MachineShop provides a Backup Wizard to guide you 
through the process of backing up a project running on a 
runtime workstation to a selected target. The target can be 
a variety of storage devices including diskette, Compact 
Flash, hard drive, or network. 

To create a backup of a project on a runtime worksta¬ 
tion, complete the following steps: 

Note If you have the MLSC installed, you should 

perform an additional step before step 1 below to 
make sure you are backing up the most current 
files. You should first copy the project from the 
MLSC. For more information, see the Project 
Files section in Chapter 6. 

1. Select the Connection you want to use from the 
Select Connection box on the MachineShop toolbar. 
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2. Select the Create Backup command from the Tools 
menu. 

The Create Backup submenu appears. 

3. Select the Remote System command from the Create 
Backup submenu. 

The Backup Wizard appears. 

4. Follow the instructions provided by the Backup 
Wizard to finish backing up the project. 

MachineShop also allows you to restore a project backup 
to the runtime system. This is done using the Restore 
Wizard. The Restore Wizard will automatically decom¬ 
press the backup project and load it on the runtime work¬ 
station. 

To restore a project backup to a runtime workstation, 
complete the following steps: 

1 . Select the Connection you plan to use from the Select 
Connection box on the MachineShop toolbar. 

2. Select the Restore Backup command from the Tools 
menu. 

The Restore Backup submenu appears. 

3. Select the Remote System command from the 
Restore Backup submenu. 

The Restore Wizard appears. 

4. Follow the instructions provided by the Restore 
Wizard to finish backing up the project. 

Note If you have the MLSC installed, you must perform 
an additional step after the restore is complete to 
download the project from the runtime worksta¬ 
tion to the MLSC itself. For more information, see 
the Project Files section in Chapter 6. 
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MachineLogic 

The MachineLogic option in the Shell allows you to view infor¬ 
mation about MachineLogic. This includes the state of the runtime 
kernel, I/O device errors, and the tasks included in the project. It 
also is used to configure the settings for MachineLogic PC Control 
(MLPC) and the MachineLogic Slot Card (MLSC). 

If the current project does not include MachineLogic, you may 
skip this chapter. 

Chapter Contents 
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Access 

MachineLogic 


Start and Stop 
MachineLogic 

stopping 

MachineLogic 


To access the MachineLogic option, complete the 
following step: 

• Select the MACHINELOGIC button from the Utili¬ 
ties submenu. 

The MachineLogic screen appears. Note that if you 
have the MLSC installed, the Runtime Target says 
MLSC rather than MLPC. 
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I/O Driver SUtus: 

1. SST Profibus IV*/PCW (N3.168) 
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The display area of the screen shows whether you have the 
MLPC or the MLSC installed as well as the current mode 
of the MachineLogic runtime. It also displays system 
status, project name, and error information. If an error 
condition occurs, the error number and the corresponding 
message will be displayed on the screen. 


From the MachineLogic menu, you may start and stop the 
MachineLogic runtime kernel. 


To stop MachineLogic from executing, complete the 
following steps: 

1 . Select the STOP button from the MachineLogic 
menu. 
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Starting 

MachineLogic 


The Stop submenu appears for eonfirmation. 

CIC^ MachineShopsAt// 



2. Seleet one of the following buttons: 

• YES - direets the Shell to stop the execution of 
MachineLogic 

• NO - directs the Shell to continue the execution of 
MachineLogic and to return to the MachineLogic 
main menu. 

Once MachineLogic stops, the display area of the 
MachineLogic screen is updated to show that MachineL¬ 
ogic is NOT running. 

There are three types of start modes: Cold, Warm, and 
Hot. The start modes determine how data is initialized and 
tasks are activated in the MachineLogic project. 

To start MachineLogic, complete the following steps: 

1. Select the START button from the MachineLogic 
menu. 

The Start submenu appears. Note that if you have the 
MLSC installed, the runtime target says MLSC rather 
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than MLPC. 




lA) Driver SUtus: 

1. SST Profibus ISrt/PClW <K3.18S> 
CO} • MO ERROR 


2. Select one of the following start buttons: 

• COLD - initializes all data to the default value 
and activates all user tasks. Resets all memory in¬ 
cluding retentive memory. 

• WARM - initializes non-retentive data and acti¬ 
vates all user tasks. Resets all memory except for 
retentive memory. 

• HOT - does not initialize data but does activate 
all user tasks. Keeps all memory settings. This 
option is not available if you download a new 
project or if you have just started the project. 

After making the selection, the MachineLogic runtime 
kernel is started and the display area is updated to show 
that MachineLogic is running. 

R@SGt From this menu button you can reset two options: the 
watchdog and the slot card. If you have the MLPC 
installed, the watchdog hardware timer resides on the 
MachineLogic Control Adapter (MLCA). If you have the 
MLSC installed, the watchdog timer resides on the MLSC 
itself. 

Watchdog 

If the watchdog timer exceeds the alarm threshold, the 
Reset button flashes in red and the WATCHDOG button 
is enabled and flashing. You must manually reset the 


90 


MachineShop Shell Runtime Guide 




Chapter 6: MachineLogic 


View Task Information 


watchdog timer by selecting the WATCHDOG button. 

For more information on watchdogs, see the Watchdog 
section on page 98. 

Note This option is only available when the Watchdog 
feature is enabled and the timer has exceeded the 
alarm threshold. 


Slot Card 

This option is available when the Shell detects the MLSC 
installed on your runtime workstation. Select this option 
to reset the Slot Card itself. Both the Slot Card and the 
runtime workstation are rebooted. 

To reset the watchdog timer, or to reset the Slot Card, 
complete the following step: 

• Select the RESET button from the MachineLogic 
menu. 

The Reset button is disabled. 


View Task 
Information 


You may view information about the MachineLogic tasks 
included in the installed project. The information includes 
a count of tasks and details such as task name, priority, 
and period for each task in the project. 

To display task information for the MachineLogic 
project, complete the following step: 

• Select the TASK INEO button from the MachineL¬ 
ogic menu. 
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The Task Information screen appears. 
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Configuring the 
MLPC 


N ote Your runtime workstation has either the MLC A or 
the MLSC installed. If you have the MLSC, see 
the next section. Configuring the MLSC. 

This section describes how to view and modify the current 
MLPC settings. This includes the retentive memory size 
and address, port address, hardware interrupt request, the 
watchdog and power fail status, and the UCS communica¬ 
tion card settings. 

Note Changes made to the MLCA are written to either 
the MCLA.INI file or the MACHLOG.INI file. 
See Appendix A for details on these files. 

These changes do not take effect until the work¬ 
station reboots. A confirmation message will 
display when you exit the Hardware Settings 
screen asking if you wish to reboot the worksta¬ 
tion. 

To view the current MLPC settings, complete the 
following steps: 

1. Select the NEXT button from the MachineLogic 


MLPC (MachineLogic PC Control) is the group term for 
the MachineLogic software working in conjunction with 
the MachineLogic Control Adapter (MLCA). The MLCA 
is a hardware card installed inside your runtime worksta¬ 
tion that is used by MachineLogic. The MLCA contains 
the retained memory, the Master Control Relay (MCR), 
and devices for interfacing to I/O systems. 
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Retentive Memory 


menu. 


CTC^ MachineShowsiitf/ 


HELP 



HAckineLojiic 
Ruhttue Target: PC <HlPC} 

Sy5t<* Status: OK 
Project: ItrPrflS 
NMio: Run 

I/O Driver Status: 

1. SST Profibus ISA/KIW <K3.18S> 
m • (10 ERROR 


2. Select the HARDWARE SETTINGS button from 
the MachineLogic menu. 

The MachineLogic Hardware Settings screen 
appears. 


CIC^ MaGhineShppsftew 



NactiinaLoeic 
tIMtOVARE SCTTINGS 

Retentive Heaory Sise: aHD 
Henory Oase Mdress: DddOh 
Port &ase Mdress: 7i8h 
Interrupt Request: $ 

Power Fail: Disabled 
watchDos: Disabled 
UCS Base Address: 718b 
UCS Interrupt Reojest: 6 


The Retentive Memory defines the non-volatile shared 
memory (NVSRAM) in kilobytes from 4k to 32K, incre¬ 
menting in values 4k, 8k, 16k, and 32k. 

It also defines the base memory segment for the 
NVSRAM. The base memory segment must be defined at 
an address that is evenly divisible by the memory size and 
allows the entire memory window to fit within certain 
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ranges based on the model of a PowerStation. 

Note These settings should match the resource config¬ 
ured Data Area for the MachineLogic project. See 
the MachineLogic Getting Started Guide for more 
information. 


To configure the Retentive Memory for the MLCA, 
complete the following steps: 

1. Select the RETENTIVE MEMORY button from the 
Hardware Settings menu. 

The Retentive Memory submenu appears. 


CIC^ MachineSliops/.e// 



2. Select one of the following buttons. 

• MEMORY SIZE - defines the non-volatile 
shared memory (NVSRAM) in kilobytes. A value 
of 0 will disable the NVSRAM. The default value 
of the Retentive Memory Size is 4K. 

• MEMORY ADDRESS - defines the base mem¬ 
ory segment for the NVSRAM. The default value 
of the Retentive Memory Address is OxDSOO. 

The pop-up keypad appears. 

3. Enter a valid memory size or memory address for the 

Control Adapter. 
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Interrupt Request 


4. Select the ENTER button to accept the values. 

Note These changes are stored in the MLCA.INI file. 
Changes do not take effect until the workstation 
reboots. 

The Port Address defines the I/O port address parameter, 
ranging from 0x200 to OxFFFS in multiples of eight. The 
default value of the Port Address is 0x710. 

To configure the Port Address of the MLCA, complete 
the following steps: 

1. Select the PORT ADDRESS button from the Hard¬ 
ware Settings menu. 

The pop-up keypad appears. 

2. Enter a valid port address for the Control Adapter. 

3. Press the ENTER button to accept the value. 

Note This change is stored in the MLCA.INI file. 

Changes do not take effect until the workstation 
reboots. 

The Interrupt Request defines the assigned IRQ on the 
Control Adapter. Valid IRQ numbers are 3,4,5,7,10, 11, 
12, or 15 (as long as the number does not conflict with any 
other PC IRQ assignments). 

The default value of the Interrupt Request is 5 for the 
MLCA. 

To configure the Interrupt Request for the MLCA, 
complete the following steps: 

1 . Select the INTERRUPT REQUEST button from the 
Hardware Settings menu. 

The pop-up keypad appears. 

2. Enter a valid interrupt request number for the Control 
Adapter. 

This value defines the IRQ used by the card. Set the 
IRQ to zero (0) if the Powerfail and Watchdog func¬ 
tions are disabled on the Control Adapter card. 


96 


MachineShop Shell Runtime Guide 



Chapter 6: MachineLogic 


Configuring the MLPC 


Power Fail 


3. Press the ENTER button to aceept the value. 

Note This change is stored in the MLCA.INI file. 

Changes do not take effect until the workstation 
reboots. 


The Power Fail feature is designed to proteet the runtime 
workstation in the event of an uneontrolled power loss. 
The power fail deteetion cireuit on the MLCA monitors 
the system voltage. When the +5 Volts supply drops 
below 4.75 Volts, it will generate an interrupt to shutdown 
the I/O and de-energize the MCR. This relay ean be used 
as an external indicator as part of an emergency stop 
circuit. 

To enable/disable the Power Pail feature, complete the 
following steps: 

1. Select the POWER PAIL button from the Hardware 
Settings menu. 

The Power Fail submenu appears. 


CIC^ MachineShops/it// 



2. Select one of the following buttons: 

• ENABLE - activates power fail detection on the 
MachineLogic Control Adapter 

• DISABLE - deactivates power fail detection on 
the MachineLogic Control Adapter 

Note This change is stored in the MACHLOG.INI file. 
Changes do not take effect until the workstation is 
rebooted. 
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Watchdog 


The Watchdog hardware timer notifies the user of a 
system failure (hardware or software) that affects the 
running of MachineLogic. The control software periodi¬ 
cally sends a signal to the watchdog telling it everything 
is running fine. If the watchdog does not receive a signal 
within a set amount of time, it enters a tripped condition. 
When this occurs, the MCR is opened. Your application 
can use the MCR to react to the tripped condition. 

The Shell also reacts to the tripped condition. The RESET 
button flashes in red and the WATCHDOG button on the 
Reset submenu is enabled and flashing. You must manu¬ 
ally reset the watchdog timer by selecting the 
WATCHDOG button. 

To enable/disable the watchdog timer feature, 
complete the following steps: 

1 . Select the NEXT button from the Hardware Settings 
menu. 


C?IC^ Ma::hineShop5ft»ff 
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Retentive Howry Size: 
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2. Select the WATCHDOG button. 
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DCS Address 


The Watchdog submenu appears. 
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IMBDWtWC SETTinCS 





Port fcase Address: 719h 


Po¥er P«]l: Disabled 


WatchOof: Disabled 


UCS Interrupt Peouest: 9 


3. Select one of the following buttons: 

• ENABLE - activates the watchdog timer on the 
MLCA 

• DISABLE - deactivates the watchdog timer on 
the MLCA 

Note This change is stored in the MACHLOG.INI file. 
Changes do not take effect until the workstation is 
rebooted. 

The UCS Base Address defines the I/O port address 
parameter, ranging from 0x200 to OxFFFS in multiples of 
eight. The default value of the UCS Base Address is 
0x718. 

To configure the base address for the UCS interface 
card, complete the following steps: 

1 . Select the NEXT button from the Hardware Settings 
menu. 

2. Select the UCS ADDRESS button. 

The pop-up keypad appears. 

3. Enter a valid address for the UCS card. 

4. Press the ENTER button to accept the address value. 

Note This change is stored in the MLCA.INI file. 

Changes do not take effect until the workstation 
reboots. 
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The hardware interrupt for the UCS interfaee eard ean be 
any of the following: 3,4,5, 7, 10, 11, 12, or 15 as long as 
it does not eonfliet with any other IRQ assignments made 
by the PC. The default value of the UCS hardware inter¬ 
rupt is IRQ=0 (disabled). 

To configure the hardware interrupt for the UCS 
interface card, complete the following steps: 

1 . Select the NEXT button from the Hardware Settings 
menu. 

2. Select the UCS INTERRUPT button from the Hard¬ 
ware Settings menu. 

The pop-up keypad appears. 

3. Enter a valid IRQ number for the interrupt. 

Set the IRQ parameter to zero (0) if no interrupt is 
used. 

4. Press the ENTER button to accept the interrupt value. 

Note This change is stored in the MLCA.INI file. 

Changes do not take effect until the workstation 
reboots. 
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Configuring the 
MLSC 


The MLSC (MachineLogic Slot Card) is a hardware card 
installed inside your runtime workstation. The MLSC has 
its own processor on the card itself where MachineLogic 
resides. Unlike the MLCA, the MLSC does not have to 
share a processor on the runtime workstation to execute 
tasks. The MLSC also has an Ethernet port built on the 
card itself. 


Note Your runtime workstation has either the MLSC or 
the MLCA installed. If you have the MLCA, see 
the preceding section, Configuring the MLPC. 

This section describes how to view and modify the current 
MLSC settings. This includes the watchdog status, power 
fail status, and Ethernet I/O settings. 

Note Changes made to the MLSC are written to the card 
itself. No INI file is required. 

These changes do not take effect until the MLSC 
is rebooted. A confirmation message will display 
when you exit the Hardware Settings screen 
asking if you want to reboot the workstation. 

To view the current MLSC settings, complete the 
following steps: 

1. Select the NEXT button from the MachineLogic 
menu. 
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1/0 Driver Stetus: 
1. SSTPFftS <H3.30e) 
($0] ■ Ho Error 


2. Select the HARDWARE SETTINGS button. 
The MachineLogic Hardware Settings screen 
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appears. 
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Power Fell; Disabled 
WatchDof: Disabled 


Ethernet I/O Port 

IP Address: 18.0.0.2 
IP ha$k: 


The Power Fail feature is designed to proteet the system 
in the event of an uneontrolled power loss. The power fail 
deteetion eireuit on the MLSC monitors the system 
voltage. When the +5 Volts supply drops below 4.75 
Volts, it will generate an interrupt to shutdown the I/O and 
de-energize the MCR. This relay ean be used as an 
external indieator as part of an emergeney stop eireuit. 

To enable/disable the Power Fail feature, complete the 
following steps: 

1 . Select the POWER FAIL button from the Hardware 
Settings menu. 

The Power Fail submenu appears. 

CfC^ MachineShppsfttff 


HELP 



2. Select one of the following buttons: 

• ENABLE - activates power fail detection on the 
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Watchdog 


MachineLogic Slot Card 

• DISABLE - deactivates power fail detection on 
the MachineLogic Slot Card 

Note Changes do not take effect until the workstation is 
rebooted. 

The Watchdog hardware timer notifies the user of a 
system failure (hardware or software) that affects the 
running of MachineLogic. The control software periodi¬ 
cally sends a signal to the watchdog telling it everything 
is running fine. If the watchdog does not receive a signal 
within a set amount of time, it enters a tripped condition. 
When this occurs, the MCR is opened. Your application 
can use the MCR to react to the tripped condition. 

The Shell also reacts to the tripped condition. The RESET 
button flashes in red and the WATCHDOG button on the 
Reset submenu is enabled and flashing. You must manu¬ 
ally reset the watchdog timer by selecting the 
WATCHDOG button. 

To enable/disable the watchdog timer feature, 
complete the following steps: 

1. Select the WATCHDOG button from the Hardware 
Settings menu. 

The Watchdog submenu appears. 

CIC^ MachineShopsfttff 
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2. Select one of the following buttons: 

• ENABLE - activates the watchdog timer on the 
MLSC 
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• DISABLE - deactivates the watchdog timer on 
the MLSC 

Note Changes do not take effect until the workstation is 
rebooted. 

The MLSC has an Ethernet port on the card itself. This 
port is meant to connect to I/O racks or other devices that 
the MLSC controls. A network administrator should 
determine the IP address and the IP mask for the Ethernet 
port so the MESC can communicate across your network. 

Important We recommend that you use the MLSC Ethernet 
port on a separate Ethernet network than the one 
your runtime workstation is connected to. In other 
words, your I/O Ethernet network should be sepa¬ 
rate from your company Ethernet network. 

To set the IP address and the IP mask, complete the 
following steps: 

1. Select the ETHERNET I/O button from the Hard¬ 
ware Settings menu. 

The Ethernet I/O submenu appears. 


CIC^ MachineShopsAt/r 



2. Select one of the following buttons: 

• IP ADDRESS Enter a new IP address using 
your workstation’s keyboard. Valid ranges are 
0.0.0.1 through 255.255.255.255. The default 
value is 10.0.0.2. 

• IP MASK - Enter a new IP mask using your 
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workstation’s keyboard. Valid ranges are 
255.0.0.0 through 255.255.255.254. The default 
value is 255.255.255.0. 
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Project Files 
(MLSC Only) 


The Project Files option lets you transfer your MachineL¬ 
ogic projects to and from the MLSC. Because the MLSC 
has its own processor, it can execute MachineLogic tasks 
on its own. But to do so you must first transfer your 
MachineLogic project from the development system to 
your runtime workstation (see Chapter 5). Once you have 
accomplished this transfer, copy the project to the MLSC. 

Likewise, you can copy your project from the MLSC back 
to the development system. 

To copy your project to and from the MLSC, complete 
the following steps: 

1 . Select the NEXT button from the MachineLogic 
menu. 


CIC^ MachineShops/ietf 


HELP 



HtichineLoflc 

RuntlM T«riet: SLOT CAfiO <M.SC) 
Sy*t«« CK 

Project: ItrProfj 
HoOi: Rtri 

1/0 Driver Status: 

1. SSTPFbS <N3.30e) 

(50] a Ho Error 


2. Select the PROJECT EILES button. 


The Project Files submenu appears. 

CIC^ MactiineShops/ie/; 
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Project Files (MLSC Only) 


3. Select one of the following buttons: 

• COPY TO SLOT CARD Select OK. A mes 
sage displays saying that files are being trans¬ 
ferred and that you should wait. If the transfer is 
successful, you are prompted to reboot so the 
transfer can take effect. If the transfer fails, an er¬ 
ror dialog displays. 

• COPY FROM SLOT CARD - Select OK. A 
message displays saying that files are being trans¬ 
ferred and that you should wait. If the transfer 
fails, an error dialog displays. 
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Chapter 6: MachineLogic 
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Configuration Files 

This appendix provides the text of the files that are required for the runtime system. The 
following eonfiguration files apply to the MLPC only. 


MLCA.INI 

The text of the MLCA.INI appears below: 


[ CentrolAdapter] 

MemBaseSeg=0xD8 00 

MemSize=4 ;Set in Kbytes (0, 4, 8, 16, or 32) 

IOBase=0x710 

IRQ=5 ;(3, 4, 5, 7, 10, 11, 12, or 15) 


[UCS] 

UCSBase=0x718 

UCSIrq=0 

The parameters for MLCA.INI are deseribed in the table below. 


Parameter 

Description 

[ControlAdapter] 

Memory sizes and locations for the control 
adapter 

MemBaseSeg=0xD800 

Defines the base memory segment for the non¬ 
volatile shared memory (NVSRAM). 

The base memory segment must be defined at 
an address that is evenly divisible by the mem¬ 
ory size and allows the entire memory window 
to fit within the following ranges: 

• P1 PowerStations: OxDOOO to OxEFFF 

• 386 P2 and all 5x86 PowerStations: 0xC800 
to OxEFFF 

• Pentium PowerStations: 0xC800 to OxDFFF 
For example, OxDOOO, OxDfOO, 0xD200, etc. 
are valid base memory segments for a 4 kilo¬ 
byte memory size. 

MemSize=4 

Defines the size of the NVSRAM in kilobytes 
from 4k to 32k, incrementing by the following 
values: 4k, 8k, 16k, and 32k. A value of 0 dis¬ 
ables the NVSRAM. 

IOBase=0x710 

Defines the I/O port address ranging from 200 
to FFF8 in multiples of eight. 
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Parameter 

Description 

IRQ=5 

Defines the hardware interrupt. The IRQ you 
seiectcan be any of the foiiowing: 3,4, 5, 7,10, 
11, 12, or 15 as iong as it does not confiict with 
any other IRQ assignments made by the PC. 

Set to 0 if Powerfaii and Watchdog are dis- 
abied. 

[UCS] 

Parameters for UCS interface 

UCSBase=0x718 

Defines the l/Q port address ranging from 200 
to FFF8 in muitipies of eight. 

UCSIrq=0 

Defines the hardware interrupt. The IRQ you 
seiectcan be any of the following: 3,4, 5, 7,10, 
11, 12, or 15 as long as it does not conflict with 
any other IRQ assignments made by the PC. 

Set to 0 if no interrupt is used. 

MACHLOG.INI 


The text of the MACHLOG.INI file appears below. 


Note You can also configure these parameters from the Memory and Ports dialog 

box on the MachineShop Toolbar. 


[COM] 

Port = 1 
Baud = 19200 

[LIMITS] 

Program = 50 
Inputs = 1024 
Outputs = 1024 

[CONTROLADAPTER] 

PowerFail=ENABLED 
Watchdog=ENABLED 

[KEYBOARD] 

CtrlAltDel=DISABLED;Key sequence is ignored if disabled. 

[MACHINELOGICBOOTOPTION] 

PowerOnOperation=ENABLED 


;Set in Kbytes 

;Set in bytes on a quad boundary 
;Set in bytes on a quad bounder 
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The parameters for MACHLOG.INI are deseribed in the table below: 


Parameter 

Description 

[Comm] 

Communication parameters for down- 
ioading and upioading 

Port=1 

Defines the COM port for communicating 
with MachineLogic. 

Baud=19200 

Defines the baud rate for communicating 
with MachineLogic. 

[Limits] 

Memory iimits for controi program 

Program=50 

Defines the amount of memory in kiio- 
bytes from 1 k to 60k reserved for the 
controi program. 

lnputs=1024 

Defines the amount of memory in bytes 
reserved for inputs to the controi pro¬ 
gram. This vaiue can range from 4 bytes 
to 8192 bytes. 

Outputs=1024 

Defines the amount of memory in bytes 
reserved for outputs from the controi pro¬ 
gram. This vaiue can range from 4 bytes 
to 8192 bytes. 

[ControiCard] 

Parameters for controi adapter 

Powerfaii=Disabied 

Controis whether or not the MachineLog¬ 
ic Controi Adapter powerfaii detection is 
enabied or disabied. 

Watchdog=Disabied 

Controis whether or not the MachineLog¬ 
ic Controi Adapter watchdog timer is en¬ 
abied or disabied. 

[Keyboard] 

Parameters for keyboard 

CtriAitDei=Enabied 

Controis whether or not the Ctri-i-Ait-i-Dei 
key combination for rebooting the ma¬ 
chine is enabied or disabied. 

[MachineLogicBootOption] 

Parameters for start up 

PowerOnOperation=Enabied 

Controis whether or not MachineLogic 
wiii start after the workstation is powered 
on. 
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PSU.CFG 

The text of the PSU.CFG file appears below: 


<data> 


</data> 


<application> 

<version></version> 

</application> 

<configuration> 

<poweron runitr="NO”></poweron> 

<1astlanguage>English</lastlanguage> 
<optiondata>0</optiondata> 
<displaytype>0</displaytype> 
<DirectSerial COM='’0'’ FifoTrigger='’l'’/> 
</configuration> 

<backup> 

<pathl></pathl> 

<path2></path2> 

<path3></path3> 

</backup> 

<restore> 

<pathl></pathl> 

<path2></path2> 

<path3></path3> 

</restore> 

<ftp> 

<username></username> 

<password></password> 

</ftp> 

<P5Settings> 

<shiftmode>0</shiftmode> 

<selectionkey>0</selectionkey> 
</P5Settings> 
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Installing the MachineShop Shell 

This appendix describes the steps to install the MachineShop Shell on a non-CTC 
workstation. The steps include the following: 

1. Install the MachineShop Shell software from the MachineShop Shell Installa¬ 
tion disk. 

2. Copy the NET directory and the contents of CTC directory from the PowerSta- 
tion Start disk to your PC. 

3. Modify the workstation’s AUTOEXEC.BAT file. 

Note The MachineShop Shell Installation disk and the PowerStation Start disk are 
part of the Runtime Workstation disk set. For instructions on how to create 
the Runtime Workstation disk set, see the MachineShop Installation Booklet. 
For instmctions on how to install the MachineShop Shell on a PowerStation, 
see your PowerStation User Guide. 

Install the MachineShop Shell Software 

To install the MachineShop Shell software, complete the following steps: 

1. Insert the MachineShop Shell Installation disk into drive A. 

2. Enter MS-DOS mode and change to drive A by typing A: 

3. At the DOS prompt, type Install A: C:. 

4. Press Enter to execute this command. 

You will be asked if you want to continue with the installation. 

5. Type Y for Yes in order to continue. 

6. After the installation is complete, remove the MachineShop Shell Installation 
disk from drive A and then reboot your system. 

Copy Files to the Non-CTC Workstation 

After the installation is complete, you must copy the NET directory and the contents of 
the CTC directory from the PowerStation Start disk to the non-CTC workstation. 

To copy the files to the non-CTC workstation, complete the following steps: 

1. Insert the PowerStation Start disk into drive A. 
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2. Copy the A:\NET directory to C:\NET. 

3. Copy the contents of the A:\CTC directory into the C:\CTC directory. 

Modify the AUTOEXEC.BAT file 

You should modify your workstation’s AUTOEXEC.BAT file so that MachineEogic 
operates properly. Modify the AUTOEXEC.BAT according to whether you have the 
MachineEogic Control Adapter (MECA) or the MachineEogic Slot Card (MESC) 
installed. 

MLCA 

If you have the MECA installed, you may add these lines to the end of your 
AUTOEXEC.BAT file. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kifififif 

REM Add the CTC folder to the system's PATH. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 


PATH %PATH%;C:\CTC 
REM 

REM Load the MachineLogic Control Adapter driver if it is present. 
REM 


IF NOT EXIST C:\MACHLOG\NDL.EXT MD C:\MACHLOG 
CD \MACHLOG 

IF NOT EXIST C:\CTC\MLCA.EXE GOTO NOMLCA 
CD \CTC 

LH C:\CTC\MLCA 
:NOMLCA 


REM 

'k'k'k'k-k'kif-k-k-kif-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k-k 

REM Set up Interact and MachineLogic environment variables for MS Shell. 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kifififif 


SET INTERACT=C:\INTERACT 
SET INTERACT_FILES=C:\INTERACT\APPFILES 
SET INTERACT_STARTDP=C:\STARTDP 
SET MACHINELOGIC=C:\MACHLOG 
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REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k 

REM Load NETWORK drivers — NOVELL and/or TCPIP stack. 

REM Remove REM on the CALL statement to load NOVELL network batch file. 
REM If used, this must be called BEFORE loading the TCPIP stack. 

REM 

'k'k'k'kif-k-k-kifif-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

CD \NET 

REM CALL C:\NET\NET.BAT 
LH C:\NET\TCPIP 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

REM Load MachineLogic if ML kernel present 
REM (determined by MLDU.EXE return value 0 
REM 

'k'k'ki(i(i('ki(i(i(-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 


, and set for boot operation. 
= ENABLED, 1 = DISABLED) 


IF NOT EXIST C:\MACHLOG\NUL.EXT MD C:\MACHLOG 
CD \MACHLOG 

IF NOT EXIST C:\MACHLOG\MACHLOG.EXE GOTO NOME 
C:\CTC\MLDU 

IF ERRORLEVEL 1 GOTO NOME 

C:\MACHLOG\RTXDOS 
C:\MACHLOG\MACHLOG 


:NOML 


REM 

REM Start the MachineShop Shell. 
REM 


CD \CTC 
PSU 


MLSC 

If you have the MLSC installed, you may add these lines to the end of your 
AUTOEXEC.BAT file. 

@ECHO OFF 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

REM Add the CTC folder to the system's PATH 
REM 
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'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k-k 

PATH %PATH%;C;\CTC 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kififif-k 

REM Set up Interact environment variables for MS Shell. 

REM 

'k'k'k'k-k-k-k-k-k'kif-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k-k 

SET INTERACT=C:\INTERACT 

SET INTERACT_FILES=C:\INTERACT\APPFILES 

SET INTERACT_STARTDP=C:\STARTDP 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

REM If an external mouse is connected, MOUSE will install successfully 
REM and create a new MOUSE.INI file. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kififif-k 

CD \CTC 

IF EXIST C:\CTC\MODSE.INI DEL C:\CTC\MODSE.INI 
LH C:\CTC\MOUSE 


REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kififif-k 

REM Check for the presence of a MachineLogic Slot Card (MLSC). 

REM Set up MachineLogic environment variables for MS Shell. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 


SET MACHINELOGIC=C:\MACHLOG 

IF NOT EXIST C;\MACHLOG\NUL.EXT MD C:\MACHLOG 
IF NOT EXIST C:\CTC\TST4MLSC.EXE GOTO NO_MLSC 
TST4MLSC C;\NET\TCPIP.INI 0x7E MLSC OxDOOO 
IF ERRORLEVEL 2 GOTO BAD_MLSC 
IF ERRORLEVEL 1 GOTO GOOD_MLSC 
GOTO NO_MLSC 


:GOOD_MLSC 

REM *** MLSC Present and has IP - launch packet driver 
SET MLSC=GOOD 

C:\NET\MLSC_PKT 0x7E OxDOOO 
GOTO DO_TOUCH 


:BAD_MLSC 

REM *** MLSC Present but doesn't have IP or may not be functioning prop¬ 
erly 

SET MLSC=BAD 
GOTO DO_TOUCH 


:NO_MLSC 
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REM *** No MLSC, may or may not have MLPC (find out later) 

SET MLSC=NONE 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k 

REM Load the MachineLogic Control Adapter driver if it is present. 

REM 

CD \MACHLOG 

IF NOT EXIST C;\CTC\MLCA.EXE GOTO NOMLCA 
CD \CTC 

LH C;\CTC\MLCA 

:NOMLCA 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

REM Launch packet drivers here. 

REM If you are using the PACKET Interface for any of your networks, 

REM launch the packet drivers here. 

REM 

'k'k'k'k'kifif-k-k-kif-kif-kifif'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k-k 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k 

REM Load NETWORK drivers — NOVELL 

REM Remove REM on the CALL statement to load NOVELL network batch file. 
REM If used, this must be called BEFORE loading the TCPIP stack. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k 

CD \NET 

REM CALL C:\NET\NET.BAT 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k 

REM Load TCP/IP Stack 

REM If MLSC is present always load TCPIP. 

REM If no MLSC, check for MLPC. 

REM 

'k'k'k'l('k-k-k-ki(-ki(i(i(-ki(-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

IF %MLSC% == NONE GOTO :MLPC_TCP 
GOTO TCPNOML 

:MLPC_TCP 

REM 

REM If MachineLogic is set for boot operation (MLDU.EXE returns 0), 

REM TCP/IP must be run with the -NORTC option, to prevent interference 
REM with MachineLogic! MachineLogic will install TCP/IP as a task. 

REM 

'k'k'kif'k-k-k-k-k-kififif-kifif'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

C: \CTC\MLDU 

IF ERRORLEVEL 1 GOTO TCPNOML 
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LH C:\NET\TCPIP -NORTC 
GOTO TCPCONT 

:TCPNOML 

LH C;\NET\TCPIP 

:TCPCONT 


REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

REM Load MachineLogic if ML kernel present, and set for boot operation. 
REM (determined by MLDU.EXE return value 0 = ENABLED, 1 = DISABLED) 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kififif-k 

IF %MLSC% == NONE GOTO MAYBE_MLPC 
GOTO NO_MLPC 


:MAYBE_MLPC 

IF NOT EXIST C;\MACHLOG\NUL.EXT MD C:\MACHLOG 
CD \MACHLOG 

IF NOT EXIST C;\MACHLOG\MACHLOG.EXE GOTO NO_MLPC 
C:\CTC\MLDU 

IF ERRORLEVEL 1 GOTO NO_MLPC 


C:\MACHLOG\RTXDOS 
C:\MACHLOG\MACHLOG 


:NO_MLPC 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kif-kif-k 

REM Call AUTOEXEC.BAT file contained in project, if it exists. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

IF NOT EXIST C:\STARTaP\NDL.EXT MD C:\STARTaP 
CD \STARTUP 

IF EXIST C:\STARTDP\ADTOEXEC.BAT CALL C:\STARTDP\ADTOEXEC.BAT 
REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k-k-k 

REM Start the MachineShop Shell. 

REM 

'k'k'k'k-k-k-k-k-k-k-k-k-k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kif-k-k-k 

CD \CTC 
PSU 
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Serial connection 76 
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Startup Program 19 
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Stop command 88 
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T 

Task Info command 91 
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TCP/IP settings 56 
time and date 

setting system 24-??, 24-?? 
Title Area 11 

Transfer Module command 37 
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u 
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configure base address 99 
configure interrupt 100 
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V 
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w 
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